Kode error dan amplop error

1. Setiap 4xx dan 5xx mengembalikan { "error": { type, code, message, param?, doc_url, request_id, errors? } }.
2. Cabangkan berdasarkan type untuk memutuskan apakah percobaan ulang masuk akal, dan petakan code ke sistem Anda sendiri.
3. param menunjuk ke field yang bermasalah, misalnya lines.0.vat_rate; errors[] muncul jika ada beberapa.
4. Catat request_id di setiap kesalahan — dengan itu kami dapat menemukan permintaan tepat di log kami.

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 dan dua tipe upstream dapat dicoba ulang. authentication_error, permission_error, dan invalid_request_error tidak diperbaiki dengan mencoba ulang.
• 404 juga dikembalikan untuk id yang milik tenant lain: kami tidak pernah mengonfirmasi bahwa data orang lain ada.
• 409 idempotency_key_reuse berarti Anda memakai ulang kunci dengan isi yang berbeda. Jangan memaksanya: periksa apa yang sudah diterbitkan.
• doc_url di setiap error langsung menunjuk ke bagian error dalam dokumentasi ini.
• Pesan berbahasa Rumania karena API melayani alur fiskal Rumania; jangan mengurai message, cabangkan berdasarkan code.