Codes d'erreur

Testez le error_code, pas le message : le code est stable, le message peut être reformulé.

Forme d'une erreur

{
  "success": false,
  "message": "Clé API invalide.",
  "error_code": "NGP001",
  "legacy_code": "LP001"
}

Le champ data est absent des réponses d'erreur. Une intégration qui lit data sans vérifier success plantera sur la première erreur.

Un 429 porte l'en-tête Retry-After (secondes). Les réponses des routes appelables avec la clé secrète portent aussi X-RateLimit-Limit et X-RateLimit-Remaining.

Catalogue

Erreur de validation détaillée

{
  "success": false,
  "message": "Données invalides.",
  "error_code": "NGP_VALIDATION",
  "errors": {
    "amount": ["Le montant doit être au moins 100."],
    "reference": ["Le champ reference est obligatoire."]
  }
}

Anciens codes LP

Les codes ont porté le préfixe LP jusqu'au 17 septembre 2026. Chaque réponse d'erreur expose encore l'ancien code dans legacy_code, pour qu'une intégration qui teste LP001 puisse basculer sans coupure.

Gestion des erreurs

const r = await fetch(url, options);
const body = await r.json();

if (!body.success) {
  // Testez le code, jamais le message.
  if (body.error_code === 'NGP016') return alerterSoldeInsuffisant(body.message);
  if (body.error_code === 'NGP003') return reessayerPlusTard();
  throw new Error(body.message);
}

Que réessayer

Le rejeu avec la même reference est sûr : l'idempotence garantit qu'on n'encaisse — ni ne vire — deux fois.