/v1 hibaválasz application/problem+json formátumú (RFC 9457), rögzített mezőkészlettel:
code alapján ágaztassa el a feldolgozást, soha ne a detail alapján – a code egy stabil, géppel olvasható szerződés, míg a detail ember által olvasható, és változhat. A param akkor szerepel a válaszban, ha a hiba egy adott kérésparaméterhez köthető. A támogatással való kapcsolatfelvételkor adja meg a request_id értékét is.
Hibakódok
A kódkészlet zárt: az új kódok a nyilvános szerződés módosításának minősülnek, és az API változásnaplóján keresztül kerülnek közzétételre. A
retryable: true válasz azt jelenti, hogy a helyzet megoldódhat; ez nem bizonyítja, hogy az írási művelet nem járt hatással. Az olvasási kéréseket korlátozott számú próbálkozással és időkerettel, exponenciális visszalépéssel (backoff) és jitterrel próbálja újra. Ha jelen van a Retry-After, vegye figyelembe, akkor is, ha az újrapróbálható 409 vagy 429 válaszban szerepel.
A módosító műveletek esetében kövesse az adott művelet dokumentált idempotencia- és helyreállítási szerződését. Ha támogatott, őrizze meg az eredeti kulcsot és kérést. Időtúllépés vagy 5xx után ne hozzon létre új kulcsot: ez egy már sikeres írási művelet megismétlését eredményezheti. Az Idempotency-Key fejléc nem nyújt védelmet olyan műveletnél, amely nem támogatja azt.