त्रुटि कोड और समस्या निवारण
मानकीकृत HTTP त्रुटि संरचना, स्थिति कोड सूची और लचीलापन रणनीतियाँ।
यदि किसी अनुरोध को सफलतापूर्वक संसाधित नहीं किया जा सकता है, तो SmallPict त्वरित डिबगिंग के लिए संरचित JSON ऑब्जेक्ट के साथ एक मानक HTTP स्थिति कोड लौटाता है।
JSON त्रुटि संरचना
JSON
{ "success": false, "error": { "code": "INVALID_IMAGE_PAYLOAD", "message": "प्रदान की गई फ़ाइल एक वैध छवि नहीं है या दूषित है।", "details": { "mime_type": "text/html", "expected": [ "image/jpeg", "image/png", "image/webp", "image/avif" ] } }}HTTP स्थिति कोड तालिका
| कोड | त्रुटि पहचानकर्ता | कारण | अनुशंसित समाधान |
|---|---|---|---|
400 | BAD_REQUEST | अमान्य JSON या गलत पैरामीटर। | JSON प्रारूप और फ़ील्ड नामों की जांच करें। |
401 | UNAUTHORIZED | API कुंजी अनुपलब्ध या निरस्त है। | X-API-Key हेडर की पुष्टि करें। |
401 | TIMESTAMP_DRIFT | टाइमस्टैम्प ±300s से अधिक विचलित है। | सर्वर समय को NTP से सिंक करें। |
401 | INVALID_SIGNATURE | परिकलित HMAC-SHA256 हस्ताक्षर मेल नहीं खाता। | विहित स्ट्रिंग और Secret Key की जांच करें। |
403 | FORBIDDEN | कुंजी के पास इस संसाधन के लिए अनुमति नहीं है। | डैशबोर्ड में कुंजी की अनुमतियां समायोजित करें। |
404 | NOT_FOUND | निर्दिष्ट कार्य (job_id) या फ़ाइल मौजूद नहीं है। | URL में पहचानकर्ता की जांच करें। |
413 | PAYLOAD_TOO_LARGE | फ़ाइल आपके प्लान की अधिकतम फ़ाइल आकार सीमा से अधिक है। | अपलोड करने से पहले फ़ाइल का आकार कम करें। |
415 | UNSUPPORTED_MEDIA | असमर्थित मीडिया प्रारूप। | केवल JPEG, PNG, WebP, AVIF या SVG भेजें। |
422 | UNPROCESSABLE | एक्सटेंशन सही है लेकिन फ़ाइल दूषित है। | सुनिश्चित करें कि फ़ाइल पूरी तरह से अपलोड हुई है। |
429 | RATE_LIMIT_EXCEEDED | प्रति सेकंड अनुरोध सीमा पार हो गई। | एक्सपोनेंशियल बैकऑफ़ के साथ पुनर्प्रयास करें। |
429 | QUOTA_EXCEEDED | मासिक ट्रांसफ़ॉर्मेशन कोटा समाप्त हो गया। | डैशबोर्ड में अपनी योजना अपग्रेड करें। |
500 | INTERNAL_ERROR | प्रोसेसिंग सर्वर क्लस्टर में अप्रत्याशित त्रुटि। | कुछ समय बाद अनुरोध पुनः भेजें। |
503 | SERVICE_UNAVAILABLE | अनुसूचित रखरखाव या अत्यधिक ट्रैफ़िक। | अस्थायी रूप से passthrough मोड का उपयोग करें। |