हर error एक ही JSON shape का उपयोग करता है, इसलिए एक ही handler उन सभी को कवर करता है।
{
"error": {
"code": "forbidden",
"message": "this API key is missing the \"write\" scope"
}
}
Status codes
| Status | code | कब |
|---|---|---|
| 400 | validation_error | Body या query की validation असफल हुई। error.fields हर field का नाम बताता है |
| 401 | unauthorized | Key missing, invalid, revoked या disabled है |
| 402 | plan_limit | आपका plan इसमें शामिल नहीं है, या कोई plan limit पहुँच गई है |
| 403 | forbidden | Key के पास इस endpoint के लिए ज़रूरी scope नहीं है |
| 404 | not_found | यह resource इस workspace में मौजूद नहीं है |
| 429 | rate_limited | इस key से बहुत ज़्यादा requests की गई हैं |
| 500 | internal_error | हमारी तरफ़ कुछ गलत हो गया। backoff के साथ retry करें |
Rate limits
हर key 60 seconds में 120 requests कर सकती है, और यह REST API तथा MCP server के बीच shared होता है। Responses में standard RateLimit और RateLimit-Policy headers शामिल होते हैं, ताकि limit hit होने से पहले आप speed कम कर सकें।
अच्छी practice
429और5xxresponses को exponential backoff के साथ retry करें।429के अलावा4xxerrors को retry न करें।- Keys को अपने server पर रखें। उन्हें कभी browser या mobile app में ship न करें।
- हर app के लिए अलग key उपयोग करें, ताकि आप एक को rotate या revoke कर सकें और बाकी apps प्रभावित न हों।
क्या यह मददगार था?
कुछ ही मिनटों में ब्रांड के अनुरूप पोस्ट प्रकाशित करें
दस्तावेज़ पर वापस जाएँAI कंटेंट, शेड्यूलिंग, एंगेजमेंट और एक पूरी मार्केटिंग सूट — शुरू करने के लिए मुफ़्त।
मुफ़्त में शुरू करें
