API রেফারেন্স

এই রেফারেন্সে শুধুমাত্র প্রকৃত, প্রকাশ্যে ব্যবহারযোগ্য JSON এন্ডপয়েন্ট বর্ণনা করা হয়েছে -- প্রতিটি এন্ডপয়েন্টের জন্য মেথড, পাথ, প্রমাণীকরণের ধরন, বাধ্যতামূলক প্যারামিটার, উদাহরণ রিকোয়েস্ট ও রেসপন্স এবং নথিভুক্ত এরর কোড। Zentor-এ কোনো সাধারণ ডেভেলপার API-কী ব্যবস্থা নেই; রুট অনুযায়ী অ্যাক্সেস হয় প্রমাণীকরণ ছাড়াই, নয়তো Origin যাচাইসহ একটি উইজেট এমবেড টোকেনের মাধ্যমে। অভ্যন্তরীণ ড্যাশবোর্ড রুট এবং Master Admin এন্ডপয়েন্ট ইচ্ছাকৃতভাবে এই পাবলিক রেফারেন্সের অংশ নয়, কারণ এগুলো কেবল নিয়মিত লগইন সেশনের মাধ্যমেই অ্যাক্সেসযোগ্য।

প্রতিটি এন্ডপয়েন্ট এন্ট্রিতে একটি লাইভ-টেস্ট নোট থাকে, যা জানায় তথ্যটি রেজিস্ট্রি স্কিমা, একটি স্বয়ংক্রিয় টেস্ট নাকি প্রকৃত লাইভ পর্যবেক্ষণ থেকে এসেছে -- কোনো কার্যকর কোড পাথের সঙ্গে নিছক সাদৃশ্যকে পূর্ণ প্রমাণ হিসেবে গণ্য করা হয় না। এছাড়া প্রযুক্তিগতভাবে সফল একটি কল সর্বদা কেবল সংশ্লিষ্ট রিকোয়েস্টটির প্রক্রিয়াকরণ নিশ্চিত করে, ইমেইল ডেলিভারি, পেমেন্ট সম্পন্ন হওয়া বা সম্পূর্ণ SSO লগইনের মতো পরবর্তী প্রক্রিয়াগুলো স্বয়ংক্রিয়ভাবে নিশ্চিত করে না।

সুরক্ষা সংশ্লিষ্ট গ্রুপের ওপর নির্ভর করে। পাবলিক আইনি, মার্কেটিং ও ফর্ম এন্ডপয়েন্টের জন্য কোনো ড্যাশবোর্ড সেশন লাগে না। অন্যদিকে চ্যাট উইজেট `X-Widget-Token` হেডার এবং একটি Origin অনুমোদন তালিকা ব্যবহার করে। ড্যাশবোর্ড লগইন বারো ঘণ্টা মেয়াদের একটি সেশন JWT এবং সাত দিন বৈধ একটি রিফ্রেশ টোকেন প্রদান করে। SSO এন্ডপয়েন্টগুলো নিজস্ব এককালীন কোড ও কলব্যাক প্রবাহ নিয়ে কাজ করে।

প্রতিটি এন্ডপয়েন্ট পৃষ্ঠাকে একটি স্বতন্ত্র চুক্তি হিসেবে পড়ুন। HTTP মেথড, পাথ, বাধ্যতামূলক প্যারামিটার, ডেটা টাইপ, রিকোয়েস্ট বডি, রেসপন্স কাঠামো, এরর কোড এবং আইডেমপোটেন্সি নির্ধারক। একটি উদাহরণ একটি সম্ভাব্য ফরম্যাট দেখায়, কিন্তু প্রকৃত রেসপন্স যাচাইয়ের বিকল্প নয়। কনফিগারেশন অবস্থা, ভ্যালিডেশন, অনুমতি এবং বাহ্যিক প্রদানকারী ফলাফল পরিবর্তন করতে পারে।

নিশ্চিত প্ল্যাটফর্ম-ব্যাপী রেট লিমিট হলো ১৫ মিনিটে ২,০০০ রিকোয়েস্ট। প্রতিটি এন্ডপয়েন্টের আলাদা লিমিট সর্বত্র নথিভুক্ত নয়। তাই ক্লায়েন্টদের অপ্রয়োজনীয়ভাবে ঘন পোলিং লুপ ব্যবহার করা উচিত নয়। নন-আইডেমপোটেন্ট অপারেশনে স্বয়ংক্রিয় পুনরাবৃত্তি ডুপ্লিকেট রেকর্ড বা বার্তা তৈরি করতে পারে।

সংবেদনশীল মান লগে রাখা উচিত নয়। এর মধ্যে রয়েছে পাসওয়ার্ড, রিসেট টোকেন, যাচাইকরণ কোড, উইজেট টোকেন, সেশন আইডি এবং বাস্তব ব্যক্তিগত উদাহরণ ডেটা। ডকুমেন্টেশন ও টেস্টে বেনামি মান ব্যবহার করুন। লাইভ-টেস্ট নোটে প্রকৃত প্রমাণ সঠিকভাবে প্রতিফলিত হতে হবে।