Auth & clés API
Tokens bearer, rotation de clés, liste blanche d'IP et erreurs que vous verrez quand l'auth échoue.
Tokens bearer
Chaque requête vers https://api.eveses.com porte une clé API en tant que token bearer :
Authorization: Bearer 17|aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789abcd
Les clés se créent dans Account → API Keys. Traitez-les comme des mots de passe — elles donnent un accès complet au solde, activations et locations.
Créer
Cliquez sur New key, donnez-lui une étiquette (local-dev, ci, production-eu). Le token est affiché une fois à la création — stockez-le immédiatement.
Roter
Les clés ne sont pas éditables. Pour roter : créez-en une nouvelle → remplacez dans le déploiement → supprimez l'ancienne. La suppression est immédiate.
Liste blanche d'IP
Allowlist par clé : attachez une clé à des IPs / plages CIDR spécifiques. Les requêtes hors liste reçoivent 403. Configuration sur la page de détail de la clé.
Scopes
Toutes les clés donnent actuellement un accès complet. Les clés par scope (read-only, rentals-only) sont sur la feuille de route.
Erreurs
| HTTP | Signification |
|---|---|
| 401 | Authorization manquant ou malformé |
| 403 | Clé révoquée, compte suspendu, ou IP hors allowlist |
| 429 | Rate limit par clé dépassé (défaut 60 rpm) |