দাবা রেটিং API ডকুমেন্টেশন

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

টুর্নামেন্ট-মোড এন্ডপয়েন্ট প্রতি-রাউন্ড ব্রেকডাউন এবং ক্রমবর্ধমান মোট প্রতিপক্ষের রেটিং এবং ফলাফলের একটি অর্ডারকৃত অ্যারে গ্রহণ করে। সমস্ত প্রতিক্রিয়াগুলির মধ্যে মেটাডেটা অন্তর্ভুক্ত রয়েছে যে কোন নিয়ম প্রোফাইল প্রয়োগ করা হয়েছিল যাতে ডাউনস্ট্রিম গ্রাহকরা গণনা অনুমানগুলি যাচাই করতে পারে৷

API অ্যাক্সেসের জন্য অনুমোদন শিরোনামে একটি বহনকারী টোকেন হিসাবে পাস করা একটি API কী প্রয়োজন৷ কীগুলি বিনামূল্যে এবং প্রিমিয়াম স্তরগুলিতে উপলব্ধ৷ বিনামূল্যের স্তর প্রতি ব্যাচ অনুরোধে সর্বাধিক 10টি গেম সহ প্রতিদিন 100টি অনুরোধের অনুমতি দেয়। প্রিমিয়াম কীগুলি উচ্চতর থ্রুপুট, অগ্রাধিকার সমর্থন এবং বাল্ক টুর্নামেন্ট প্রক্রিয়াকরণের শেষ পয়েন্টগুলিতে অ্যাক্সেস আনলক করে।

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

প্রতিটি API প্রতিক্রিয়ায় একটি নিয়ম_প্রোফাইল ক্ষেত্র রয়েছে যা নির্দেশ করে যে অনুমানের সেটটি গণনার জন্য ব্যবহার করা হয়েছে (যেমন, fide_2024, us_chess_current, generic_elo)। যখন ফেডারেশন প্রবিধান পরিবর্তন হয়, তখন API বিদ্যমানগুলিকে সংশোধন করার পরিবর্তে একটি নতুন প্রোফাইল সংস্করণ যোগ করে। এর মানে হল ডাউনস্ট্রিম সিস্টেমগুলি একটি নির্দিষ্ট প্রোফাইল সংস্করণে পিন করতে পারে এবং তাদের নিজস্ব সময়সূচীতে আপগ্রেড করতে পারে।

এপিআই চেঞ্জলগ এবং ডেভেলপার মেলিং তালিকার মাধ্যমে ব্রেকিং পরিবর্তনগুলি কমপক্ষে 30 দিন আগে যোগাযোগ করা হয়। অ-ব্রেকিং সংযোজন (নতুন ঐচ্ছিক ক্ষেত্র, নতুন প্রোফাইল) বিদ্যমান ইন্টিগ্রেশন ব্যাহত না করে ক্রমাগত স্থাপন করা হয়।

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

ক্লাব সফ্টওয়্যার এবং কোচিং ড্যাশবোর্ডের জন্য, গণনা করা ফলাফল এবং নিয়ম_প্রোফাইল সংস্করণ উভয়ই সংরক্ষণ করার কথা বিবেচনা করুন যাতে ফেডারেশনের নিয়ম পরিবর্তন হলে আপনি পরে অডিট বা পুনঃগণনা করতে পারেন। এটি অফিসিয়াল রিপোর্টিং কর্মপ্রবাহের জন্য বিশেষভাবে গুরুত্বপূর্ণ যেখানে ঐতিহাসিক নির্ভুলতা গুরুত্বপূর্ণ।