Référence de l'API
Gestion des Erreurs
Codes d'erreur standards, en-têtes de limite de débit et dépannage.
Dernière mise à jour :
Gestion des erreurs
Toutes les réponses d'erreur suivent un format cohérent avec un code d'erreur et un message lisible par l'humain :
{
"error": {
"code": "ERROR_CODE",
"message": "Description of what went wrong"
}
}Codes d'erreur
| HTTP Status | Code | Description |
|---|---|---|
| 400 | VALIDATION_ERROR | Paramètres de requête invalides ou manquants |
| 401 | UNAUTHORIZED | Clé API manquante ou invalide |
| 402 | PAYMENT_REQUIRED | Crédits insuffisants |
| 403 | FORBIDDEN | L'accès à l'API nécessite le plan Business, ou action non autorisée |
| 403 | LIMIT_EXCEEDED | Limites du plan atteintes (projets, builds, etc.) |
| 404 | NOT_FOUND | Ressource introuvable ou inaccessible |
| 409 | CONFLICT | Conflit de ressource (déploiement en cours, domaine déjà pris, etc.) |
| 429 | RATE_LIMITED | Trop de requêtes — vérifiez les en-têtes de limite de débit |
| 500 | INTERNAL_ERROR | Erreur serveur — réessayez ou contactez le support |
En-têtes de limite de débit
Chaque réponse inclut ces en-têtes :
X-RateLimit-Remaining— Nombre de requêtes restantes dans la fenêtre actuelleX-RateLimit-Reset— Secondes avant la réinitialisation de la fenêtre de limite de débit
Lorsque vous recevez une réponse 429, attendez le nombre de secondes indiqué par X-RateLimit-Reset avant de réessayer.
Coûts en crédits
Actions API qui consomment des crédits :
| Action | Credits |
|---|---|
| Création de projet (build initial) | 5 |
| Affinage | 1 |
| Modification de code | 1 |
| Redéploiement | 1 |
| Rollback | 1 |
| Clone | 2 |
| Réactivation | 1 |
| Question au conseiller | 1 |
Les administrateurs sont exemptés des charges de crédits.
Dépannage
- 401 Unauthorized — Vérifiez que votre clé API commence par
flp_et est incluse comme jeton Bearer - 403 Forbidden — Vérifiez que votre compte dispose d'un abonnement Business actif
- 409 Conflict lors d'un déploiement — Attendez que le déploiement en cours se termine, ou annulez-le d'abord
- Erreurs de sous-domaine — Les sous-domaines doivent être en minuscules, 3-63 caractères, et ne contenir que des lettres, des chiffres et des tirets