শুরু করুন

ত্রুটি

কোনো সমস্যা হলে API সংশ্লিষ্ট HTTP স্ট্যাটাস এবং এমন একটি বডি ফেরত দেয়, যার error-এর ভেতরে থাকে code ও message।

আপনার প্রোগ্রামে code ব্যবহার করুন। message হলো ডিবাগ করার সুবিধার জন্য ইংরেজিতে লেখা একটি টেক্সট, যা বদলে যেতে পারে।

ত্রুটির ফরম্যাট404

{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}

কী ছাড়া401

{
  "error": {
    "code": "missing_api_key",
    "message": "Send your API key in the X-API-Key header or as Authorization: Bearer <key>."
  }
}

ত্রুটির কোড

স্ট্যাটাস	কোড	কখন ঘটে
400	`key_in_query`	কী পাঠানো হয়েছে URL-এ (প্যারামিটার `api_key`, `apikey`, `key` বা `token`)। কী হেডারে পাঠান এবং নতুন একটি কী তৈরি করুন, কারণ আগের কী-টি লগে সংরক্ষিত হয়ে থাকতে পারে।
400	`invalid_parameter`	কোনো প্যারামিটারের মান অবৈধ, যেমন সর্বোচ্চ সীমার বেশি `per_page`।
401	`missing_api_key`	অনুরোধে কোনো কী ছিল না।
401	`invalid_api_key`	কী-টির অস্তিত্ব নেই, এটি প্রত্যাহার করা হয়েছে, অথবা এর ব্যবহারকারী নিষ্ক্রিয়।
404	`not_found`	এন্ডপয়েন্টটির অস্তিত্ব নেই, অথবা আইটেমটির অস্তিত্ব নেই বা এটি এমন প্রতিষ্ঠানের, যা ব্যবহারকারী দেখতে পারেন না।
404	`organization_not_found`	দেওয়া `organization` এমন কোনো প্রতিষ্ঠান নয়, যেখানে ব্যবহারকারী এই ধরনের আইটেম দেখতে পারেন।
405	`method_not_allowed`	API শুধু `GET` (এবং `HEAD`) গ্রহণ করে।
429	`rate_limited`	অনুরোধের সীমায় পৌঁছে গেছে। `Retry-After`-এ দেওয়া সেকেন্ড পর্যন্ত অপেক্ষা করুন।
500	`server_error`	অভ্যন্তরীণ ত্রুটি। কিছুক্ষণ পর আবার চেষ্টা করুন; সমস্যা থেকে গেলে সহায়তা কেন্দ্রে যোগাযোগ করুন।

কখন আবার চেষ্টা করবেন

একই অনুরোধ আবার পাঠান শুধু 429 (Retry-After পর্যন্ত অপেক্ষা করে) অথবা 500-এর পরে। অন্য ত্রুটিগুলোর ক্ষেত্রে অনুরোধ বা কী ঠিক করতে হবে।