ত্রুটি

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

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

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

json

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

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

কোড	অর্থ	কখন ঘটে
`400`	Bad Request	অনুপস্থিত বা অবৈধ প্যারামিটার
`402`	Payment Required	মাসিক অ্যাওয়ার্ড কোটা পৌঁছেছে বা বৈশিষ্ট্যের জন্য উচ্চতর প্ল্যান প্রয়োজন
`403`	Forbidden	প্ল্যান-সীমা পৌঁছেছে (যেমন ইস্যুয়ার বা ব্যাজ ক্যাপ)
`404`	Not Found	অনুরোধিত রিসোর্স বিদ্যমান নেই
`429`	Too Many Requests	রেট সীমা অতিক্রম
`500`	Internal Server Error	সার্ভারে একটি অপ্রত্যাশিত ত্রুটি ঘটেছে

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

প্রয়োজনীয় প্যারামিটার অনুপস্থিত

json

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

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

অবৈধ ইমেল

json

{ "error": "invalid email" }

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

অবৈধ URL

json

{ "error": "invalid URL" }

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

নাম অত্যন্ত ছোট

json

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

সমাধান: একটি দীর্ঘ নাম ব্যবহার করুন। ইস্যুয়ারের নামের জন্য কমপক্ষে 3 অক্ষর প্রয়োজন। প্রাপকের নামের জন্য কমপক্ষে 5 অক্ষর প্রয়োজন।

ইস্যুয়ার যাচাইকৃত নয়

json

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

সমাধান: প্রথমে ইস্যুয়ার যাচাই করুন। যাচাইকরণ লিঙ্কের জন্য ইস্যুয়ার ইমেল চেক করুন, অথবা Verify Issuer এন্ডপয়েন্ট ব্যবহার করুন।

মাসিক অ্যাওয়ার্ড কোটা পৌঁছেছে

json

{ "error": "monthly award quota reached" }

সমাধান: আপনি এই বিলিং সময়ের জন্য আপনার প্ল্যানে অন্তর্ভুক্ত সমস্ত অ্যাওয়ার্ড ব্যবহার করেছেন (Free: 100/mo, Starter: 1,000/mo, Pro: 10,000/mo)। পরবর্তী রিসেটের জন্য অপেক্ষা করুন বা আপনার প্ল্যান আপগ্রেড করুন। প্ল্যান ও বিলিং দেখুন।

প্ল্যান সীমা পৌঁছেছে

json

{ "error": "issuer limit reached for your plan" }

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

ব্লকচেইনের জন্য Pro প্রয়োজন

json

{ "error": "blockchain verification requires the Pro plan" }

সমাধান: blockchain প্যারামিটার শুধুমাত্র Pro প্ল্যানে উপলব্ধ। অন-চেইন যাচাইকরণ সক্ষম করতে আপগ্রেড করুন।

অসমর্থিত ব্লকচেইন

json

{ "error": "unsupported blockchain, only 'matchain' is supported" }

সমাধান: বর্তমানে ব্লকচেইন প্যারামিটার হিসেবে শুধুমাত্র matchain সমর্থিত।

রিসোর্সের নির্ভরতা রয়েছে

json

{ "error": "issuer has badges and cannot be deleted" }

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

অনুমোদিত নয়

json

{ "error": "not authorized" }

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

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

json

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

সমাধান: শেয়ার টেক্সট সাধারণ টেক্সট হওয়া উচিত। text প্যারামিটার থেকে যেকোনো HTML ট্যাগ সরান।

ত্রুটি ​