Authentification

RouteAPI utilise l’authentification Bearer Token. Toutes les requêtes API doivent inclure un Token valide dans l’en-tête Authorization.

Format de l’en-tête

Authorization: Bearer sk-your-routeapi-token

Exemple :

curl https://www.routeapi.ai/v1/models \
  -H "Authorization: Bearer $ROUTEAPI_KEY"

Créer un API Token

1. Connectez-vous à la console RouteAPI.
2. Ouvrez la page API keys.
3. Créez un nouveau Token.
4. Définissez, si nécessaire, le nom, le quota, les droits d’accès et la période de validité.
5. Enregistrez le Token et utilisez-le uniquement côté serveur ou dans un environnement sûr.

Token et droits

Un Token est généralement influencé par les paramètres suivants :

Paramètre	Impact
Solde utilisateur	Si le solde est insuffisant, la requête peut retourner 402
Quota du Token	Chaque Token peut avoir un quota ou une date d’expiration indépendants
Limitation de fréquence	Retourne 429 lorsqu’elle est déclenchée

Recommandations de sécurité

• N’exposez pas le Token dans le code frontend, un dépôt public ou une configuration mobile en clair.
• Pour les appels serveur, stockez de préférence le Token dans une variable d’environnement.
• En cas de fuite, désactivez ou supprimez immédiatement le Token, puis générez-en un nouveau.
• Créez des Token distincts pour les différentes applications afin de faciliter l’audit et les limites.
• Définissez un quota faible et une expiration courte pour les Token de test temporaires.

Erreurs d’authentification courantes

Code d’état	Causes fréquentes	Traitement recommandé
401	Token manquant, faute de frappe, Token supprimé	Vérifiez l’en-tête Authorization
402	Solde insuffisant ou quota épuisé	Rechargez, augmentez le quota ou changez de Token
429	Limitation déclenchée	Réduisez la concurrence et vérifiez les règles de limite utilisateur ou Token