/v1 त्रुटि प्रतिक्रिया application/problem+json (RFC 9457) प्रारूप में होती है, जिसमें फ़ील्ड का एक निश्चित समूह होता है:
code के आधार पर करें, detail के आधार पर कभी नहीं — code एक स्थिर मशीन अनुबंध है; detail मानव-पठनीय है और बदल सकता है। जब त्रुटि किसी विशिष्ट अनुरोध पैरामीटर के कारण हो, तब param उपलब्ध होता है। सहायता टीम से संपर्क करते समय request_id शामिल करें।
Error codes
कोड समूह सीमित है: नए कोड जोड़ना सार्वजनिक अनुबंध में परिवर्तन है और इसकी घोषणा API चेंजलॉग के माध्यम से की जाती है।
retryable: true प्रतिक्रिया का अर्थ है कि स्थिति स्वतः ठीक हो सकती है; यह इस बात का प्रमाण नहीं है कि लिखने (write) के ऑपरेशन का कोई प्रभाव नहीं पड़ा। रीड अनुरोधों को सीमित प्रयासों और समय-सीमा के भीतर, एक्सपोनेंशियल बैकऑफ़ और जिटर के साथ पुनः प्रयास करें। जब Retry-After उपलब्ध हो, तब उसका पालन करें, पुनः प्रयास योग्य 409 या 429 पर भी।
म्यूटेशन के लिए, ऑपरेशन के प्रलेखित idempotency और रिकवरी अनुबंध का पालन करें। जहाँ समर्थित हो, मूल कुंजी (key) और मूल अनुरोध को यथावत रखें। टाइमआउट या 5xx के बाद नई कुंजी न बनाएँ: ऐसा करने से सफल हो चुका write दोबारा निष्पादित हो सकता है। जो ऑपरेशन Idempotency-Key हेडर का समर्थन नहीं करता, उस पर यह हेडर कोई सुरक्षा प्रदान नहीं करता।