समीक्षा 2026-11-10 · API संस्करण 2026-11-09 · Markdown पढ़ें
एरर, रिट्राइ और रिकवरी
API एरर { "error": { "code": "…", "message": "…", "requestId": "…" } } का उपयोग करते हैं,
साथ में वैकल्पिक फ़ील्ड एरर, गंतव्य एरर, रिट्राइ हिंट और एक्शन हैंडऑफ़।
सपोर्ट के लिए requestId सुरक्षित रखें। डायग्नोस्टिक्स इकट्ठा करते समय क्रेडेंशियल,
साइन किए अपलोड URL या संवेदनशील रिक्वेस्ट कंटेंट लॉग न करें।
| प्रतिक्रिया | रिकवरी |
|---|---|
401 unauthenticated | अनुपस्थित, दूषित या रद्द प्रोडक्ट की जाँचें |
403 forbidden_scope / account_not_allowed | की स्कोप और गंतव्य एक्सेस देखें |
402 account_limit, seat_limit, storage_limit | वर्कस्पेस एंटाइटलमेंट और संसाधन उपयोग देखें |
402 subscription_inactive / trial_expired | बिलिंग स्थिति सुलझाएँ; ड्राफ़्ट और क्यू किया काम सुरक्षित रखें |
409 revision_conflict | वर्तमान वर्ज़न पढ़ें, बदलाव देखें और जानबूझकर दोबारा लागू करें |
409 idempotency_conflict | की अलग बॉडी से दोबारा उपयोग हुई; मूल ऑपरेशन रिकंसाइल करें |
409 consent_required | अधिकृत व्यक्ति से दिया गया रिव्यू हैंडऑफ़ पूरा करने को कहें |
409 too_late_to_cancel | वास्तविक डिलीवरी स्थिति देखें; रद्दीकरण सफल होने का दावा न करें |
media_expired / media_deleting | मूल फ़ाइलें दोबारा अपलोड करें और ड्राफ़्ट अपडेट करें |
422 validation_failed | संरचित फ़ील्ड या प्रति-गंतव्य समस्याएँ सुधारें |
429 rate_limited | Retry-After का सम्मान करें; कॉनकरेंसी घटाएँ और बैकऑफ़ करें |
submission_unknown | दूसरा सबमिशन आज़माने से पहले मौजूदा बाहरी परिणाम रिकंसाइल करें |
सुरक्षित म्यूटेशन रिट्राइ
पहले म्यूटेशन से पहले आइडेंपोटेंसी की बनाएँ और उसकी सटीक रिक्वेस्ट सुरक्षित रखें।
यदि प्रतिक्रिया खो गई, तो ऑपरेशन पहले ही सफल हो सकता है। वही रिक्वेस्ट उसी
की से रिप्ले करें; नेटवर्क टाइमआउट के कारण ताज़ा की न बनाएँ। MCP म्यूटिंग टूल
अपनी की इको करते हैं, transport_outcome_unknown विफलताओं में भी। एडाप्टर
म्यूटेशन ऑटो-रिट्राइ नहीं करता।
तकनीकी वर्कस्पेस गति सीमाएँ पोस्टिंग क्रेडिट नहीं हैं। वर्तमान प्लान और रेट
जानकारी के लिए /usage का उपयोग करें। केवल ट्रांज़िएंट एरर के लिए जब उचित हो
बैक ऑफ़ करें; ऑथराइज़ेशन, वैलिडेशन या मानवीय-सहमति एरर का कारण बदले बिना
पुनः प्रयास मदद नहीं करता।
आंशिक सफलता और निगरानी
स्वीकृत पब्लिश/शेड्यूल बैच स्वतंत्र डिलीवरी का सेट है। सफल रसीदें और नेटिव लिंक सुरक्षित रखें। विफल गंतव्य को उसके अपने रिट्राइ एंडपॉइंट से रिकवर करें, पूरा बैच दोबारा न बनाएँ। साइन किए वेबहुक प्राथमिकता दें; पोलिंग करें तो बढ़ती देरी के साथ बाउंडेड प्रयास करें और अनरिज़ॉल्व्ड काम व्यक्ति तक पहुँचाएँ।