Clés API personnelles (PISTE Legifrance)
Par défaut, OpenLegi utilise des clés API partagées avec des limites de débit. Pour un usage intensif ou professionnel, vous pouvez configurer vos propres credentials PISTE.
Avantages des clés personnelles
- Aucune limite de débit — Pas de quota partagé avec d'autres utilisateurs
- Mode illimité — Vos requêtes ne sont plus comptabilisées
- Stockage sécurisé — Vos credentials sont chiffrés
Obtenir vos credentials PISTE
- Rendez-vous sur https://piste.gouv.fr (portail PISTE)
- Créez un compte ou connectez-vous
- Créez une application et souscrivez à l'API Legifrance
- Attendez l'approbation de votre application (peut prendre quelques jours)
- Une fois approuvée, accédez à votre application en environnement Production
- Récupérez votre identifiant OAuth (pas API Keys) (= Client ID) et votre Consumer Secret (= Client Secret)
Configurer dans OpenLegi
- Connectez-vous sur auth.openlegi.fr
- Accédez à votre Dashboard
- Onglet Clés OAuth → cliquez sur Ajouter une clé
- Renseignez un nom, votre Client ID et Client Secret
- La validation automatique teste vos credentials (jusqu'à 30 secondes)
- Si la validation réussit, votre clé passe en statut Active
Statuts possibles
| Statut | Signification | Action |
|---|---|---|
| Active | Credentials valides, prêts à l'emploi | Rien à faire |
| En attente | La validation n'a pas pu aboutir (timeout) | Cliquez sur Tester pour relancer |
| Invalide | Credentials rejetés par l'API PISTE | Vérifiez vos credentials (voir erreurs courantes) |
Erreurs courantes
"Client ID ou Client Secret invalide" (erreur invalid_client)
- Vérifiez que vous utilisez les credentials de l'environnement Production (pas Sandbox)
- Vérifiez que votre application PISTE est bien approuvée (statut "Approved")
- Attention aux espaces invisibles lors du copier-coller
- Le Consumer Key et le Consumer Secret sont différents du login/mot de passe PISTE
"Timeout de connexion"
- Le serveur de validation n'a pas répondu à temps
- Cela peut indiquer des credentials invalides (le serveur retente plusieurs fois avant d'échouer)
- Vérifiez d'abord vos credentials, puis cliquez sur Tester
"Accès interdit" (erreur 403)
- Votre application PISTE n'a probablement pas souscrit à l'API Legifrance
- Connectez-vous sur le portail PISTE et vérifiez vos souscriptions
Gestion des clés
- Une seule clé active par provider — Supprimez l'ancienne avant d'en créer une nouvelle
- Bouton Tester — Relance la validation à tout moment
- Bouton Supprimer — Supprime la clé et repasse automatiquement en clés partagées
- Toggle "Clés personnelles" — Active/désactive l'utilisation de vos clés (nécessite une clé active)