ত্রুটি

কোনো API অনুরোধ ব্যর্থ হলে badges.ninja একটি উপযুক্ত HTTP স্ট্যাটাস কোডসহ JSON ত্রুটি রেসপন্স ফেরত দেয়।

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

সব ত্রুটি এই কাঠামো অনুসরণ করে:

{
  "error": "description of what went wrong"
}

স্ট্যাটাস কোড

কোড	অর্থ	কখন ঘটে
400	Bad Request	প্যারামিটার অনুপস্থিত বা অবৈধ, প্ল্যান-সীমা বা কোটা শেষ, ফিচারের জন্য উচ্চতর প্ল্যান প্রয়োজন, অথবা অনুমোদিত নয় — সব ভ্যালিডেশন ব্যর্থতাই 400 ফেরত দেয়
402	Payment Required	ক্রেডিট শেষ হয়ে যাওয়ার জন্য সংরক্ষিত। badges API বর্তমানে ক্রেডিট কাটে না, তাই বাস্তবে এই কোড কখনও ফেরত আসে না
404	Not Found	অনুরোধ করা রিসোর্স বিদ্যমান নেই
500	Internal Server Error	সার্ভারে একটি অপ্রত্যাশিত ত্রুটি ঘটেছে

403 বা 429 নেই: অনুমোদনের ব্যর্থতায় 400 ("not authorized") ফেরত আসে এবং অ্যাপ্লিকেশন স্তরে কোনো রেট লিমিটিং নেই।

সাধারণ ত্রুটি ও সমাধান

আবশ্যক প্যারামিটার অনুপস্থিত

{ "error": "missing required parameters: name, url, email" }

সমাধান: আপনার অনুরোধের বডিতে সব আবশ্যক প্যারামিটার অন্তর্ভুক্ত করুন। সম্পূর্ণ তালিকার জন্য এন্ডপয়েন্টের ডকুমেন্টেশন দেখুন।

অবৈধ ইমেইল

{ "error": "invalid email" }

সমাধান: user@domain.com ফরম্যাটে একটি বৈধ ইমেইল ঠিকানা দিন।

অবৈধ URL

{ "error": "invalid URL" }

সমাধান: প্রোটোকলসহ পূর্ণ URL দিন, যেমন https://example.com.

নাম খুব ছোট

{ "error": "name must be at least 3 characters" }

সমাধান: আরও বড় নাম ব্যবহার করুন। ইস্যুকারীর নামে কমপক্ষে ৩টি অক্ষর লাগে। প্রাপকের নামে কমপক্ষে ৫টি অক্ষর লাগে।

ইস্যুকারী যাচাই করা হয়নি

{ "error": "issuer must be verified before creating badges" }

সমাধান: আগে ইস্যুকারীকে যাচাই করুন। যাচাইকরণ লিংকের জন্য ইস্যুকারীর ইমেইল দেখুন, অথবা ইস্যুকারী যাচাই এন্ডপয়েন্ট ব্যবহার করুন।

ক্রেডেনশিয়াল কোটা শেষ (400)

{ "error": "Your Free plan reached its credential limit (1200/1200) — your allowance renews on your plan anniversary, or upgrade to Starter" }

সমাধান: আপনি আপনার সম্পূর্ণ বার্ষিক ক্রেডেনশিয়াল পুল ব্যবহার করে ফেলেছেন (Free: বছরে ১,২০০, Starter: বছরে ১২,০০০, Pro: বছরে ১,২০,০০০)। পুলটি আপনার অ্যাকাউন্টের নিবন্ধন বার্ষিকীতে রিসেট হয় — ক্যালেন্ডার মাসের সীমানায় নয়। বেশি সীমার জন্য আপনার প্ল্যান আপগ্রেড করুন। দেখুন প্ল্যান ও বিলিং।

প্ল্যান সীমা শেষ (400)

{ "error": "Your Free plan reached its issuer limit (2/2) — delete an issuer or upgrade to Starter" }

ব্যাজের সীমাও একই আকারের হয়:

{ "error": "badge limit reached (5/5 on the starter plan) — delete a badge or upgrade your plan" }

সমাধান: আপনি আপনার প্ল্যানের ইস্যুকারী বা ব্যাজের সীমায় পৌঁছে গেছেন। একটি অব্যবহৃত রিসোর্স মুছে ফেলুন অথবা প্ল্যান আপগ্রেড করুন।

রিসোর্সের নির্ভরতা আছে (400)

{ "error": "issuer has 3 badge(s) linked — delete the badges first" }

সমাধান: ইস্যুকারী মুছে ফেলার আগে তার সাথে যুক্ত সব ব্যাজ মুছে ফেলুন। একইভাবে, ব্যাজ মুছে ফেলার আগে সেই ব্যাজের অধীনের সব ক্রেডেনশিয়াল মুছে ফেলুন।

অনুমোদিত নয় (400)

{ "error": "not authorized" }

অনুমোদনের ব্যর্থতা ভ্যালিডেশন ত্রুটি, তাই এগুলো 400 ফেরত দেয় (401 বা 403 নয়)।

সমাধান: আপনি কেবল নিজের মালিকানাধীন রিসোর্স পরিবর্তন করতে পারেন। সঠিক API কী ব্যবহার করছেন কিনা নিশ্চিত করুন।

শেয়ার টেক্সটে HTML

{ "error": "HTML tags are not allowed" }

সমাধান: শেয়ার টেক্সট অবশ্যই সাধারণ টেক্সট হতে হবে। text প্যারামিটার থেকে সব HTML ট্যাগ সরিয়ে ফেলুন।