/v1 kļūdas atbilde ir application/problem+json (RFC 9457) ar fiksētu lauku kopu:
code, nekad pēc detail — code ir stabils mašīnlasāms līgums, savukārt detail ir cilvēkam lasāms un var mainīties. param ir norādīts, ja kļūdu var attiecināt uz konkrētu pieprasījuma parametru. Sazinoties ar atbalsta komandu, pievienojiet request_id.
Kļūdu kodi
Kodu kopa ir slēgta: jauni kodi ir publiska līguma izmaiņas, un par tiem tiek paziņots API izmaiņu žurnālā.
retryable: true atbilde nozīmē, ka situācija var atrisināties; tā nepierāda, ka rakstīšanas darbībai nebija nekādas ietekmes. Lasīšanas pieprasījumus atkārtojiet ar ierobežotu mēģinājumu skaitu un laika budžetu, izmantojot eksponenciālo atkāpšanos un jitteru. Ņemiet vērā Retry-After, ja tas ir norādīts, arī atkārtojamas 409 vai 429 gadījumā.
Mutācijām ievērojiet attiecīgās darbības dokumentēto idempotences un atkopšanas līgumu. Ja tas tiek atbalstīts, saglabājiet sākotnējo atslēgu un pieprasījumu. Neizveidojiet jaunu atslēgu pēc noildzes vai 5xx: tas var atkārtot sekmīgi veiktu rakstīšanu. Galvene Idempotency-Key nesniedz nekādu aizsardzību darbībai, kas to neatbalsta.