Authentification
Chaque appel à l’API s’authentifie avec une clé API placée dans l’en-tête X-API-Key.
curl https://api.lexiafrik.com/v1/whoami -H "X-API-Key: $LEXIAFRIK_API_KEY"
Une clé commence par lx_. Elle est rattachée à votre compte : l’offre, le quota et le crédit
sont ceux du compte, quelle que soit la clé utilisée.
Gardez vos clés secrètes
Ne les mettez ni dans du code public, ni dans une application mobile ou un site côté navigateur. Utilisez une variable d’environnement, ou un serveur qui appelle l’API à votre place.
Obtenir une clé
| Méthode | Quand l’utiliser |
|---|---|
lexiafrik login | Sur votre ordinateur de développement. Aucune clé à copier. |
| Page Clés API du site | Pour un serveur, une application déployée, l’intégration continue. |
POST /v1/keys | Pour créer des clés par programme, avec une clé existante. |
Connexion depuis le terminal
lexiafrik login affiche un code et ouvre le navigateur. Vous vous connectez sur lexiafrik.com
(avec votre méthode habituelle), vérifiez que le code correspond, puis cliquez sur Autoriser.
Une clé dédiée à ce terminal est alors créée et enregistrée dans ~/.lexiafrik/credentials.json
(lisible par vous seul).
N’autorisez un code que si vous venez de lancer la commande vous-même. Quelqu’un qui vous demande d’approuver son code obtiendrait une clé sur votre compte.
Une clé par application
Créez une clé par application ou par environnement (production, test, CI) plutôt que d’en partager une : vous pouvez ainsi révoquer l’une sans toucher aux autres, et voir laquelle consomme quoi.
- Votre clé principale est créée avec le compte ; elle ne peut pas être révoquée.
- Les autres clés se créent, se renomment et se révoquent librement (page Clés API, ou
/v1/keys). - La rotation (
POST /v1/keys/{key_hash}/rotate) crée une nouvelle clé qui remplace l’ancienne, sans perdre l’historique ni la facturation.
Ordre de recherche du SDK Python
- le paramètre
api_key=; - la variable d’environnement
LEXIAFRIK_API_KEY; - le fichier enregistré par
lexiafrik login.
Sur ce domaine, seule la clé API est acceptée
api.lexiafrik.com n’accepte que X-API-Key. Un en-tête Authorization: Bearer y reçoit une
erreur 401. (Les sessions de connexion du site et de l’application mobile passent par un autre
domaine et ne servent pas aux intégrations.)
Erreurs d’authentification
| Code | Signification |
|---|---|
401 | Clé absente, invalide ou révoquée. |
403 | Compte suspendu, ou ressource qui ne vous appartient pas. |
Voir Erreurs.