Documentation·Auth & clés API
🔑

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)