Introduction
Tout ce dont vous avez besoin pour intégrer l'API Piloterr dans votre application.
Démarrez avec l'API Piloterr en quelques minutes. Envoyez des requêtes HTTP à nos points d'accès et recevez des réponses JSON structurées.
Démarrage rapide
Obtenez votre clé API
Inscrivez-vous sur votre tableau de bord et copiez votre clé API depuis la page Paramètres.
Effectuez votre première requête
Incluez votre clé dans l'en-tête x-api-key et appelez n'importe quel point d'accès :
curl "https://api.piloterr.com/v2/usage" \
-H "x-api-key: YOUR_API_KEY"Gérez la réponse
Chaque requête réussie retourne un objet JSON avec des données structurées. Consultez les pages individuelles des points d'accès pour les schémas de réponse et les exemples.
Authentification
Toutes les requêtes API doivent inclure un en-tête x-api-key. Vous pouvez trouver votre clé dans votre tableau de bord > clés API.
curl -H "x-api-key: xxxx" https://api.piloterr.com/v2/usageGardez votre clé API secrète. Ne l'exposez pas dans du code côté client ou dans des dépôts publics.
Codes de statut
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. |
Consultez la page Crédits pour un détail complet par point d'accès, Clés API pour la gestion des clés, et Bonnes pratiques et Gestion des erreurs pour les recommandations d'intégration. Nouveau sur la plateforme ? Le Glossaire définit tous les termes clés.
Points d'accès
Consultez chaque point d'accès dans la Référence API, ou ouvrez-en un directement :