Errors

Format błędu, reakcje na kody HTTP, retry vs stop

Standardowy format błędu

Dla /api/v1/* API opakowuje błędy jako:

{
  "error": {
    "code": "...",
    "message": "...",
    "details": null
  }
}

Reakcja na kody HTTP

• 4xx (poza 429) — zwykle nie retry
• 429 i 5xx — retry z backoff (idempotentnie)

⚠ Braki kontraktowe

Nie wszystkie błędy mają semantyczny error.code. Decyzje retry/stop opieraj głównie o HTTP status.