हिन्दी
हिन्दी
Appearance
त्रुटियाँ
जब एक 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 टैग हटाएँ।