API — Erreurs & conventions

Format d’erreur standard (backend)

Plusieurs routes backend utilisent une réponse structurée :

{
  "ok": false,
  "error": "Human readable message",
  "code": "MACHINE_CODE",
  "requestId": "...",
  "details": {}
}

• requestId est injecté par le middleware de contexte quand disponible.
• details est optionnel.

Exemples de codes fréquents

Auth / clés

• MISSING_API_KEY
• INVALID_API_KEY

API — Erreurs & conventions

Selon la route, Datalgeria renvoie soit un format “minimal” ({ error: "..." }), soit un format structuré (helper sendError). Une intégration robuste doit:

• se baser d’abord sur le code HTTP
• lire ensuite code/error si présents

Format d’erreur structuré (sendError)

{
  "ok": false,
  "code": "MACHINE_CODE",
  "error": "Human readable message",
  "requestId": "<optional>",
  "details": {}
}

Format minimal (legacy)

Certaines routes renvoient uniquement:

{ "error": "..." }

Statuts HTTP (convention)

Codes courants (Gateway / Marketplace)