/v1 je application/problem+json (RFC 9457) s pevně stanovenou sadou polí:
code, nikdy podle detail — code je stabilní strojový kontrakt, zatímco detail je určeno pro člověka a může se změnit. param je přítomno, pokud lze chybu přiřadit ke konkrétnímu parametru požadavku. Při kontaktování podpory uveďte request_id.
Kódy chyb
Sada kódů je uzavřená: nové kódy představují změnu veřejného kontraktu a jsou oznamovány prostřednictvím changelogu API. Odpověď
retryable: true znamená, že se situace může vyřešit; neprokazuje, že operace zápisu neměla žádný účinek. Operace čtení opakujte s omezeným počtem pokusů a omezeným časovým rozpočtem, s exponenciálním odstupem (backoff) a náhodným rozptylem (jitter). Pokud je přítomna hlavička Retry-After, respektujte ji, a to i u opakovatelné odpovědi 409 nebo 429.
U mutací postupujte podle zdokumentovaného kontraktu dané operace pro idempotenci a obnovu. Pokud je to podporováno, zachovejte původní klíč i původní požadavek. Po vypršení časového limitu nebo po 5xx nevytvářejte nový klíč: mohlo by dojít k opakování úspěšného zápisu. Hlavička Idempotency-Key neposkytuje žádnou ochranu u operace, která ji nepodporuje.