Idempotentnost i greške

Svaki POST, PATCH i DELETE pod /public/v1 zahtijeva zaglavlje Idempotency-Key od 16 do 100 vidljivih ASCII znakova.

Idempotency-Key: erp-tenant-42-invoice-983104

Ključ pripada API klijentu. Klik Račun uz njega veže metodu, putanju, tijelo, vrstu sadržaja i relevantna upravljačka zaglavlja. Jednaki ponovljeni zahtjev vraća spremljeni odgovor uz:

Idempotent-Replayed: true

Isti ključ s drukčijim zahtjevom vraća 409 IIPROXY_IDEMPOTENCY_KEY_REUSED. Zahtjev koji je još u obradi vraća 409 IIPROXY_REQUEST_IN_PROGRESS.

Oblik greške

{
  "error": {
    "code": "IIPROXY_TENANT_MISMATCH",
    "message": "The UBL supplier OIB does not belong to this API client."
  }
}

Interni stog poziva, SQL pojedinosti i sadržaj tuđe organizacije nikada se ne vraćaju.

HTTP	Značenje
`400`	Neispravan JSON, OAuth zahtjev ili sintaksa
`401`	Nevaljana vjerodajnica ili bearer token
`403`	Nedostaje ovlast ili je organizacija neusklađena
`404`	Resurs ne postoji ili ne pripada klijentu
`409`	Sukob verzije, lanca, idempotentnosti ili tijeka
`413`	Tijelo zahtjeva prelazi dopuštenu veličinu
`415`	Nepodržani `Content-Type`
`422`	Poslovna, UBL, fiskalizacijska ili provjera podmirenja nije prošla
`429`	Prekoračena stopa zahtjeva
`503`	Vanjski ishod je nepoznat ili ovisna usluga nije dostupna

Nemojte naslijepo ponavljati 503

Najprije pročitajte zapis operacije. Ako je status ACTION_REQUIRED, novi prijenos može proizvesti duplikat i zato ostaje blokiran do usklađenja.

Oblik greške​

Oblik greške