code lisible par machine. Cette page liste tous les codes, classés par domaine. Chaque page d’endpoint liste aussi les codes que cet endpoint renvoie le plus souvent.
Blob Storage a sa propre liste de codes, et l’AI Gateway répond au format d’erreur d’OpenAI avec des codes en minuscules. Aucun des deux n’est couvert ici.
Format des erreurs
La liste des codes s’allonge avec le temps. Traitez un code inconnu comme un échec générique du statut HTTP qui l’accompagne : corrigez la requête sur un
4xx, patientez sur un 429, et réessayez plus tard sur un 5xx.Nouvelles tentatives
L’API n’envoie pas d’en-têteRetry-After, la décision vous revient donc. Une politique sûre :
202 SNAPSHOT_PROCESSING conserve l’enveloppe d’erreur pour des raisons de compatibilité, mais ce n’est pas un échec : le snapshot est encore en cours de génération et apparaîtra de lui-même dans la liste. Ne le redemandez pas.
Limites de débit
Deux codes répondent429, et ils n’ont pas le même sens :
RATE_LIMITED: le budget de requêtes de votre compte ou de votre clé API, compté par tranche de 60 secondes et fixé par votre plan (voir les valeurs par plan). Au-delà, l’API refuse vos requêtes pendant 30 minutes au maximum. Quelques endpoints répondent aussiRATE_LIMITEDpour leurs propres limites, et une adresse IP qui continue d’envoyer des clés API n’appartenant à aucun compte est bloquée pendant une courte période.KEEP_CALM: la limite propre à un endpoint, par exemple un redémarrage toutes les quelques secondes. Patientez un instant et réessayez. La limite de chaque endpoint figure sur sa page.
Authentification et permissions
Validation des requêtes
Quotas et limites de connexion
Applications
Envoi et commit
Vérifications du zip et de la configuration
Lorsque vous envoyez une application, le serveur qui va l’exécuter vérifie le zip et son fichier de configuration (squarecloud.app ou squarecloud.config). Une vérification en échec répond 400 avec l’un de ces codes, et rien n’est déployé. Corrigez le zip et envoyez-le à nouveau. Un commit ne lit pas le fichier de configuration : parmi ces codes, il ne peut échouer qu’avec FAILED_EXTRACT ou CONTAINER_INSUFFICIENT_DISK_SPACE.
Variables d’environnement
Fichiers
Déploiements et GitHub
Un déploiement Git en échec n’est pas une erreur HTTP : il apparaît dans l’historique des déploiements sous forme d’événement avec
state: "error" et un code comme DEPLOY_FAILED.
Réseau et domaines
Snapshots
Bases de données
Workspaces
Plateforme
Les codes
AI_* (AI_DAILY_LIMIT_REACHED, AI_NO_PLAN_LIMIT_REACHED, AI_MAX_CONCURRENT_STREAMS, AI_UNAVAILABLE) appartiennent à l’assistant IA du tableau de bord, qui nécessite une session du tableau de bord. Une clé API ne les reçoit jamais.Voir aussi
- Authentification et scopes
- Limites de débit par plan
- SDK JavaScript :
SquareCloudAPIError - SDK Python :
SquareCloudAPIError - SDK Go :
*APIError

