Xatolarni qayta ishlash
HTTP status va RFC 7807 problem document’larni ajrating.
Problem document
Application xatolari RFC 7807 problem document formatida qaytadi. Qaror qabul qilishda type maydonidan foydalaning: bir nechta tur bir xil statusga ega bo‘lishi mumkin. title — odam o‘qishi uchun matn, barqaror mashina identifikatori emas.
{
"type": "THE_RETURNED_PROBLEM_TYPE",
"title": "Human-readable explanation",
"status": 400
}Bu strukturaviy misol, haqiqiy error type emas. Har bir endpointning API Reference sahifasidagi response sxemasini tekshiring. Authentication failure body’si bo‘sh kelishi mumkin; barcha javoblarni shartsiz JSON parse qilmang.
Status kodlari
| Status | Client harakati |
|---|---|
400 | Inputni tekshiring, response’dagi field/problemlarni ko‘rsating. |
401 | Credential/proof yoki session yaroqsiz. Xavfsiz refresh siyosati yoki qayta login. |
403 | Permission, tenant yoki Origin rad etilgan; auth tekshiruvini aylanib o‘tmang. |
404 | Resurs yo‘q yoki ushbu scope’da ko‘rinmaydi. |
409 | Conflict yoki lifecycle cheklovi; endpoint tavsifiga qarang. |
429 | Rate limit; Retry-After mavjud bo‘lsa unga amal qiling. |
5xx | Natija noma’lum bo‘lishi mumkin; yozish/refresh operatsiyalarini ko‘r-ko‘rona qaytarmang. |
Qayta urinish
O‘qish so‘rovlarini cheklangan backoff bilan qayta urinish mumkin. Yozish so‘rovida natija noma’lum bo‘lsa avval haqiqiy holatni tekshiring; endpoint aniq kafolat bermaguncha umumiy idempotency header ishlaydi deb hisoblamang.
Support logiga tokenlar, parollar, email proof yoki to‘liq moliyaviy payloadni qo‘ymang. Xavfsiz diagnostic va kerak bo‘lsa correlation identifikatorini saqlang.