Présentation de l'API de la plateforme
L’API de la plateforme permet à des scripts et à des systèmes tiers de gérer votre compte RouteAPI en votre nom : consulter le solde, créer et gérer les clés API, et consulter les logs du compte (avec export CSV/JSONL) ainsi que les statistiques d’usage.
Base URL : https://www.routeapi.ai/api/open/v1
Authentification : Authorization: Bearer rat_xxxx — voir Authentification de l’API de la plateforme pour créer et conserver une clé de gestion.
Exemple de requête
Section intitulée « Exemple de requête »curl https://www.routeapi.ai/api/open/v1/balance \ -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY"Tous les endpoints sous /api/open/v1 utilisent le même en-tête. Les réponses utilisent le corps unifié { success, message, data } ; voir Erreurs et limites pour ce format, les codes d’erreur et les limites de débit.
Montants et devise
Section intitulée « Montants et devise »Les champs de montant sont exprimés dans la devise d’affichage du site, avec deux décimales (par exemple 10.00) ; la devise est retournée par Obtenir le solde. Chaque montant est arrondi séparément ; un montant total peut donc différer de jusqu’à 0,01 de la somme des montants ligne par ligne.
Pagination
Section intitulée « Pagination »Les endpoints de liste utilisent la même pagination par page :
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
p | integer | 1 | Numéro de page, de 1 à 1000000 |
page_size | integer | 10 | Éléments par page, de 1 à 1000 |
Un p ou page_size fourni explicitement doit rester dans ces plages. Les valeurs non entières, 0, négatives ou hors plage retournent 400 invalid_request ; elles ne sont jamais remplacées ni plafonnées silencieusement. Les champs page / page_size de la réponse sont les valeurs réellement appliquées.
Pour les endpoints de logs, total est compté jusqu’à 10000 et vaut toujours 10000 au-delà ; récupérez les données plus anciennes par fenêtres temporelles plus courtes.
Encodage de la query string
Section intitulée « Encodage de la query string »N’insérez pas de ; brut dans la query string ; encodez-le en %3B, sinon la requête entière retourne 400 invalid_request. Encodez % en %25 et utilisez + ou %20 pour les espaces.
Liste des endpoints
Section intitulée « Liste des endpoints »Les chemins ci-dessous sont relatifs à https://www.routeapi.ai/api/open/v1.
| Méthode | Chemin | Description |
|---|---|---|
| GET | /balance | Obtenir le solde |
API Keys
Section intitulée « API Keys »| Méthode | Chemin | Description |
|---|---|---|
| GET | /keys | Lister les API Keys |
| GET | /keys/:id | Obtenir une API Key |
| GET | /keys/:id/key | Révéler une API Key |
| POST | /keys | Créer une API Key |
| PATCH | /keys/:id | Mettre à jour une API Key |
| DELETE | /keys/:id | Supprimer une API Key |
| Méthode | Chemin | Description |
|---|---|---|
| GET | /logs | Obtenir les logs du compte |
| GET | /logs/export | Exporter les logs |
| Méthode | Chemin | Description |
|---|---|---|
| GET | /usage | Obtenir les statistiques d’usage |
| GET | /usage/models | Obtenir l’usage par modèle |
| GET | /usage/keys | Obtenir l’usage par Key |