Кодови грешака и омот грешке

1. Сваки 4xx и 5xx враћа { "error": { type, code, message, param?, doc_url, request_id, грешке? } }.
2. Гранајте по type да бисте одлучили да ли поновни покушај има смисла, а code мапирајте у сопствени систем.
3. param показује на проблематично поље, нпр. lines.0.vat_rate; грешке[] се појављује када их има више.
4. Бележите request_id при свакој грешци — омогућава нам да тачно тај захтев пронађемо у нашим логовима.

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 и два апстрим типа могу се поновити. authentication_error, permission_error и invalid_request_error не решавају се поновним покушајем.
• 404 се враћа и за id који припада другом tenant-у: никада не потврђујемо да туђи подаци постоје.
• 409 idempotency_key_reuse значи да сте кључ поново употребили са другачијим телом. Немојте форсирати: проверите шта је већ издато.
• doc_url у свакој грешци води директно на одељак о грешкама у овој документацији.
• Поруке су на румунском јер API опслужује румунски фискални ток; немојте парсирати message, гранајте по code.