त्रुटि प्रबंधन (Error Handling)

ANKK पब्लिक API विस्तृत त्रुटि JSON बॉडी के साथ मानक HTTP स्थिति कोड लौटाता है।

📌 मानक त्रुटि स्कीमा (Standard Error Schema)

सभी त्रुटि प्रतिक्रियाएं निम्नलिखित स्कीमा का पालन करती हैं:

{
  "error": "idempotency_conflict",
  "message": "The idempotency key was already used with a different request payload.",
  "param": "idempotency_key"
}

🚦 HTTP स्थिति कोड संदर्भ (Status Code Reference)

स्थिति कोड (Status Code)	त्रुटि कोड (Error Code)	अर्थ और अनुशंसित कार्रवाई
`400 Bad Request`	`invalid_input`, `validation_failed`	गलत अनुरोध बॉडी या पैरामीटर्स। पेलोड ठीक करें।
`401 Unauthorized`	`unauthorized`, `invalid_api_key`	अनुपस्थित या अमान्य API कुंजी।
`403 Forbidden`	`insufficient_scope`, `quota_exceeded`	आवश्यक स्कोप अनुपस्थित या प्लान कोटा समाप्त।
`404 Not Found`	`not_found`	संसाधन (`content_id`, `connection_id`) नहीं मिला।
`409 Conflict`	`idempotency_conflict`	बेमेल पेलोड के साथ आइडम्पोटेंसी (Idempotency) कुंजी का पुन: उपयोग।
`423 Locked`	`brand_locked`	बिलिंग या नीति के कारण ब्रांड लॉक है। बिलिंग देखें।
`429 Too Many Requests`	`rate_limited`	रेट लिमिट पार हो गई। `Retry-After` के अनुसार रुकें।
`500 Server Error`	`internal_server_error`	आंतरिक सर्वर समस्या। बैकऑफ़ (backoff) के साथ पुनः प्रयास करने योग्य।
`503 Service Unavailable`	`sns_provider_unavailable`	बाहरी सोशल नेटवर्क आउटेज। बाद में पुन: प्रयास करें।

🔍 सामान्य व्यावसायिक त्रुटि उदाहरण (Common Business Error Examples)

1. 403 अपर्याप्त स्कोप (Insufficient Scope)

{
  "error": "insufficient_scope",
  "message": "The API key does not have the required 'publishing:create' scope."
}

2. 409 आइडम्पोटेंसी संघर्ष (Idempotency Conflict)

{
  "error": "idempotency_conflict",
  "message": "Idempotency key 'launch-001' is already bound to a different request hash.",
  "param": "idempotency_key"
}

3. 400 मीडिया सत्यापन विफल (Media Validation Failed)

{
  "error": "sns_content_media_maximum_exceeded",
  "message": "Bluesky supports a maximum of 4 images per post.",
  "param": "media"
}

🔁 सुरक्षित पुनः प्रयास रणनीतियाँ (Safe Retry Strategies)

पुनः प्रयास योग्य (5xx, नेटवर्क टाइमआउट): एक्सपोनेंशियल जिटर बैकऑफ़ (exponential jitter backoff) के साथ बिल्कुल उसी idempotency_key का उपयोग करके पुन: भेजें।
पुनः प्रयास करने योग्य नहीं (400, 401, 403, 404, 409): क्लाइंट कोड या पेलोड को संशोधित करें, फिर एक नई आइडम्पोटेंसी कुंजी के तहत दोबारा अनुरोध भेजें।

🔗 संबंधित दस्तावेज़