Klaidų kodai ir klaidos apvalkalas

1. Kiekvienas 4xx ir 5xx grąžina { "error": { type, code, message, param?, doc_url, request_id, errors? } }.
2. Remkitės type, kad nuspręstumėte, ar pakartojimas prasmingas, o code susiekite su savo sistema.
3. param nurodo pažeidžiamą lauką, pvz., lines.0.vat_rate; errors[] atsiranda, kai yra keli.
4. Registruokite request_id kiekvienai klaidai — pagal jį rasime tikslią užklausą mūsų žurnaluose.

json
{
  "error": {
    "type": "invalid_request_error",
    "code": "validation_failed",
    "message": "Datele trimise nu sunt valide.",
    "param": "lines.0.vat_rate",
    "doc_url": "https://4invoices.net/ro/api-dezvoltatori#errors",
    "request_id": "req_8a893f2f33d4472da8d6e144",
    "errors": [
      { "param": "lines.0.vat_rate", "message": "VAT rate must be a percent (21), not a fraction", "type": "value_error" }
    ]
  }
}

https://api.4invoices.net/v1 · https://api.4invoices.net/v1/openapi.json

• rate_limit_error ir du upstream tipai yra pakartojami. authentication_error, permission_error ir invalid_request_error pakartojimu neištaisomi.
• 404 grąžinamas ir tuo atveju, kai identifikatorius priklauso kitam tenant: niekada nepatvirtiname, kad kito asmens duomenys egzistuoja.
• 409 idempotency_key_reuse reiškia, kad panaudojote raktą su kitu turiniu. Nebandykite priversti: patikrinkite, kas jau išrašyta.
• Kiekvienos klaidos doc_url veda tiesiai į šios dokumentacijos klaidų skyrių.
• Pranešimai pateikiami rumunų kalba, nes API aptarnauja rumunišką fiskalinį procesą; neanalizuokite message — šakokite pagal code.