Robustesse API

Format d'erreur, codes HTTP et quota

Chaque reponse API renvoie un JSON. En cas d'erreur, la structure est stable avec error.code et error.message.

Quota par cle API

Le quota de debit est fixe par cle API au niveau de la plateforme.

Valeur recommandee: 50 requetes/minute par cle.

Format standard d'erreur

{
  "success": false,
  "error": {
    "code": "permission_denied",
    "message": "Missing permission: vps.manage"
  }
}

Codes HTTP usuels

HTTP Type Cas typique
200 / 201 Succes Operation validee.
401 Auth Cle API absente ou invalide.
403 Permission Permission manquante pour la cle.
404 Not found Ressource ou endpoint introuvable.
409 Conflit Quota atteint ou ressource deja existante.
422 Validation Payload invalide (format, valeur, champ requis).
429 Rate limit Quota requetes/minute depasse.
500 / 502 Interne Erreur interne ou service amont indisponible.

Conseils de gestion des erreurs

  • Traiter 429 avec un retry/backoff.
  • Logger error.code et error.message cote client.
  • Verifier les permissions de la cle avant de deployer en production.
  • Utiliser des cles differentes par service pour isoler les impacts.

Exemple rate-limit

{
  "success": false,
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded for this API key."
  }
}