Codes de statut
Codes de statut HTTP retournés par l'API Piloterr et comment les gérer.
La facturation s'applique aux requêtes réussies : 200 pour les appels synchrones, 201 pour les tâches asynchrones. La facturation du 404 varie selon le point d'accès (consultez la page de chaque point d'accès). Toutes les autres réponses 4xx/5xx sont gratuites.
| Code | Facturé | Statut | Action |
|---|---|---|---|
200 | Oui | Appel API réussi | Aucune action requise. |
201 | Oui | Tâche créée | Aucune action requise. |
202 | Non | Accepté (asynchrone) | La requête a été acceptée et est en cours de traitement. Utilisez l'ID de tâche pour vérifier le statut. |
400 | Non | Requête incorrecte | Vérifiez vos paramètres et leurs types. Consultez la documentation pour plus d'informations. |
401 | Non | Clé API invalide | Vérifiez votre clé API (en-tête x-api-key ou chaîne de requête x_api_key). |
401 | Non | Clé API inactive | Activez votre clé API dans la section Clés API des paramètres de votre compte. |
401 | Non | Clé API expirée | Mettez à jour votre clé API ou générez-en une nouvelle. |
401 | Non | Rate limit exceeded | Attendez et réessayez. Mettez à niveau votre plan ou augmentez les quotas par clé si cela se produit souvent. |
402 | Non | Payment required | Rechargez des crédits, mettez à niveau votre plan, activez le Rechargement automatique ou réglez les factures en attente. |
403 | Non | Interdit | Vérifiez vos permissions. Contactez-nous si vous pensez que c'est une erreur. |
404 | Selon le cas | Introuvable | La facturation est spécifique à chaque point d'accès. Consultez la page du point d'accès concerné. |
413 | Non | Charge trop volumineuse | Le fichier envoyé ou le corps de la requête dépasse la limite de taille. Consultez la documentation pour les tailles maximales. |
500 | Non | Erreur interne | Réessayez l'action ou contactez notre équipe de support. |