/v1 xato javobi qat’iy belgilangan maydonlar to‘plamiga ega application/problem+json (RFC 9457) formatida beriladi:
code bo‘yicha amalga oshiring, hech qachon detail bo‘yicha emas — code barqaror mashina shartnomasi hisoblanadi; detail esa inson o‘qishi uchun mo‘ljallangan va o‘zgarishi mumkin. param xatoni muayyan so‘rov parametriga bog‘lash mumkin bo‘lganda mavjud bo‘ladi. Qo‘llab-quvvatlash xizmatiga murojaat qilganingizda request_id ni ham ko‘rsating.
Error codes
Kodlar to‘plami yopiq: yangi kodlar qo‘shilishi ochiq shartnomaning o‘zgarishi hisoblanadi va API changelog orqali e’lon qilinadi.
retryable: true javobi holat o‘z-o‘zidan bartaraf bo‘lishi mumkinligini bildiradi; bu yozish amali hech qanday ta’sir ko‘rsatmaganini isbotlamaydi. O‘qish so‘rovlarini qayta yuborishda urinishlar soni va vaqt chegarasini cheklang, eksponensial backoff va jitter qo‘llang. Retry-After mavjud bo‘lsa, unga rioya qiling, jumladan qayta urinish mumkin bo‘lgan 409 yoki 429 holatlarida ham.
O‘zgartiruvchi amallar uchun operatsiyaning hujjatlashtirilgan idempotentlik va tiklash shartnomasiga amal qiling. Agar qo‘llab-quvvatlansa, dastlabki kalit va so‘rovni saqlang. Taym-aut yoki 5xx dan keyin yangi kalit o‘ylab topmang: bu muvaffaqiyatli bajarilgan yozishni takrorlashi mumkin. Idempotency-Key sarlavhasi uni qo‘llab-quvvatlamaydigan operatsiyada hech qanday himoya ta’minlamaydi.