त्रुटियाँ

जब कोई API अनुरोध विफल होता है, तो badges.ninja उपयुक्त HTTP स्टेटस कोड के साथ एक JSON त्रुटि प्रतिक्रिया लौटाता है।

त्रुटि प्रारूप

सभी त्रुटियाँ इस संरचना का पालन करती हैं:

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

स्थिति कोड

कोड	अर्थ	कब होता है
400	Bad Request	पैरामीटर अनुपस्थित या अमान्य हैं, प्लान-सीमा या कोटा पूरा हो गया है, सुविधा के लिए उच्चतर प्लान आवश्यक है, या अधिकृत नहीं हैं — सभी सत्यापन विफलताएँ 400 लौटाती हैं
402	Payment Required	credit समाप्त होने के लिए आरक्षित। badges API फ़िलहाल credits नहीं काटता, इसलिए व्यवहार में यह कोड कभी नहीं लौटाया जाता
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" }

समाधान: लंबा नाम उपयोग करें। जारीकर्ता के नाम में कम से कम 3 अक्षर होने चाहिए। प्राप्तकर्ता के नाम में कम से कम 5 अक्षर होने चाहिए।

जारीकर्ता सत्यापित नहीं है

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

समाधान: पहले जारीकर्ता को सत्यापित करें। सत्यापन लिंक के लिए जारीकर्ता का ईमेल देखें, या जारीकर्ता सत्यापित करें एंडपॉइंट का उपयोग करें।

Credential कोटा पूरा हो गया (400)

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

समाधान: आपने अपना पूरा वार्षिक credential पूल उपयोग कर लिया है (Free: 1,200/वर्ष, Starter: 12,000/वर्ष, Pro: 120,000/वर्ष)। पूल आपके खाते की पंजीकरण वर्षगाँठ पर रीसेट होता है — कैलेंडर-माह की सीमा पर नहीं। अधिक सीमा के लिए अपना प्लान अपग्रेड करें। प्लान और बिलिंग देखें।

प्लान सीमा पूरी हो गई (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" }

समाधान: जारीकर्ता को हटाने से पहले उससे जुड़े सभी बैज हटाएँ। इसी तरह, बैज को हटाने से पहले उसके अंतर्गत सभी credentials हटाएँ।

अधिकृत नहीं (400)

{ "error": "not authorized" }

प्राधिकरण विफलताएँ सत्यापन त्रुटियाँ हैं, इसलिए वे 400 लौटाती हैं (401 या 403 नहीं)।

समाधान: आप केवल अपने स्वामित्व वाले संसाधनों को संशोधित कर सकते हैं। सुनिश्चित करें कि आप सही API key का उपयोग कर रहे हैं।

शेयर टेक्स्ट में HTML

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

समाधान: शेयर टेक्स्ट सादा टेक्स्ट होना चाहिए। text पैरामीटर से सभी HTML टैग हटा दें।