SmartFlow HostRéférence de l'API
Erreurs
Format des erreurs de l'API et liste des codes.
Une erreur répond avec un statut HTTP 4xx ou 5xx et un objet error. code est stable et se teste dans votre code ; message est en français et s'affiche à une personne.
Format
{
"error": {
"code": "not_found",
"message": "Projet introuvable."
}
}Codes
| Statut | Code | Cause | Que faire |
|---|---|---|---|
| 400 | bad_request | Corps ou paramètre invalide. Le message nomme le champ en cause. | Corrigez la requête. |
| 400 | missing_files | Des fichiers du déploiement ne sont pas encore envoyés. La réponse liste leurs empreintes dans missing. | Envoyez-les par /v2/files, puis recréez le déploiement. |
| 400 | invalid_digest | Le contenu envoyé ne correspond pas à l'empreinte annoncée. | Recalculez le SHA1 du fichier. |
| 403 | forbidden | Clé absente, inconnue ou révoquée, ou clé de projet utilisée pour un autre projet. | Vérifiez la clé et sa portée. |
| 404 | not_found | Ressource introuvable, ou hors de la portée de la clé. | Vérifiez l'identifiant ou le nom. |
| 409 | conflict | Un projet porte déjà ce nom. | Choisissez un autre nom, ou utilisez le projet existant. |
| 409 | deployment_closed | Le build CI auquel ces fichiers étaient destinés a été annulé ou a échoué. | Relancez le build. |
| 413 | file_too_large | Un fichier dépasse 20 Mo. | Allégez le fichier ou servez-le ailleurs. |
| 413 | payload_too_large | Les fichiers inclus dans le corps dépassent 20 Mo au total. | Envoyez-les par /v2/files. |
| 429 | rate_limited | Trop de requêtes pour cette clé. | Attendez un instant et réessayez. |
| 500 | internal_server_error | Erreur de la plateforme. Elle nous est signalée automatiquement. | Réessayez. Si elle persiste, écrivez-nous. |
Le cas de missing_files
Ce n'est pas une vraie erreur : c'est l'étape normale d'un déploiement. La CLI la traite toute seule. Si vous écrivez votre propre client, voici la réponse :
400
{
"error": {
"code": "missing_files",
"message": "Fichiers à envoyer avant de créer le déploiement.",
"missing": [
"2ef7bde608ce5404e97d5f042f95f89f1c232871"
]
}
}