হার সীমা ও সার্ভার ত্রুটি সামলান

429 প্রতিক্রিয়া সামলান

হার-সীমায় আটকে যাওয়া অনুরোধ 429 Too Many Requests দেয়, যেখানে detail.status হলো rate_limit_exceeded। আবার চেষ্টা করার আগে প্রতিক্রিয়ার হেডার পড়ুন:

• Retry-After প্রত্যাখ্যাত অনুরোধের জন্য ন্যূনতম অপেক্ষা সেকেন্ডে জানায়।
• X-RateLimit-Limit বাকেটের সীমা জানায়।
• X-RateLimit-Remaining বাকি অনুরোধ জানায়।
• X-RateLimit-Reset বাকেট কখন রিসেট হবে জানায়।

Retry-After পর্যন্ত অপেক্ষা করে সূচকীয় ব্যাকঅফ ও কিছুটা এলোমেলো বিলম্ব নিয়ে আবার চেষ্টা করুন। একই সময়ের অনুরোধ কমান এবং সীমা রিসেট হওয়ার সঙ্গে সঙ্গে অনেক অনুরোধ না পাঠিয়ে কাজ সারিতে রাখুন।

সার্ভার ত্রুটি সামলান

500 প্রতিক্রিয়ার প্রকাশ্য বডিতে সাধারণ ত্রুটি ও request_id থাকে; অভ্যন্তরীণ ব্যতিক্রমের বিবরণ ফেরে না। 503 কোনো জরুরি সেবা সাময়িকভাবে অনুপলব্ধ বোঝাতে পারে।

শুধু পড়ার অনুরোধ সীমিত ব্যাকঅফে আবার করুন। তৈরি, হালনাগাদ, পেমেন্ট বা অন্য অবস্থা বদলানো অনুরোধ আবার পাঠানোর আগে প্রথম চেষ্টা সম্পন্ন হয়েছিল কি না নির্ধারণ করুন। টাইমআউট বা 5xx মানেই পরিবর্তন ব্যর্থ নয়; সঙ্গে সঙ্গে পুনরাবৃত্তিতে কাজ দ্বিগুণ হতে পারে।

নির্ণয়ের তথ্য রাখুন

সময়, পদ্ধতি, পথ, অবস্থা, প্রতিক্রিয়ার বডি ও X-Request-Id লিখুন। x-api-key মান কখনো লগ করবেন না। অল্প কয়েকটি সীমিত চেষ্টার পর স্বয়ংক্রিয় পুনরায় চেষ্টা থামিয়ে ব্যর্থতাটি পর্যালোচনার জন্য দেখান।