Clés de développement «API»

Qu'est-ce que l'API des développeurs ?

LeyApp met à disposition une interface REST publique API sous /api/v1 qui vous permet de rechercher des avocats, de consulter leurs disponibilités et de lancer des réservations depuis votre propre site web, votre application ou votre outil interne. L'accès en lecture de base fonctionne sans identifiants, mais une clé d'API permet d'augmenter vos limites de requêtes, de débloquer des points de terminaison supplémentaires et de bénéficier d'un tableau de bord présentant vos clés et votre utilisation.

Tout compte LeyApp peut créer des clés API — aucun type de compte particulier n'est requis. Les réservations effectuées via API ne sont jamais facturées automatiquement : le client confirme et effectue toujours le paiement sur leyapp.es. Votre intégration ne traite donc jamais d'argent ni de données de carte bancaire.

Création d'une clé « API »

La gestion des clés s'effectue depuis votre tableau de bord :

1. Dans la barre latérale, ouvrez « Tableau de bord » → « Développeur ».
2. Cliquez sur « Créer une clé » et attribuez-lui un nom descriptif, par exemple « Widget du site web (production) ».
3. Choisissez le type de clé : « Live » pour les requêtes réelles, ou « Test » pour tester en toute sécurité.
4. Copiez immédiatement la clé et conservez-la en lieu sûr, par exemple dans un gestionnaire de mots de passe ou dans l'espace de stockage sécurisé de votre hébergeur.

Clés de test et clés de production

Les clés de test (leyk_test_...) se comportent exactement comme les clés de production — mêmes points de terminaison, mêmes réponses, même validation — à une différence essentielle près : il ne se passe rien concrètement. Une demande de réservation de test est entièrement vérifiée par rapport à la disponibilité réelle, mais aucune intention de réservation n'est créée et aucun avocat n'est averti.

Les clés « Live » (leyk_...) génèrent de véritables intentions de réservation. Lorsqu'un client clique sur le lien de confirmation d'une intention « Live », il est redirigé vers le processus habituel de paiement et de confirmation sur LeyApp.

Utilisation de votre clé

Envoyez la clé dans l'en-tête « Authorization » de chaque requête : « Authorization : Bearer leyk_... ». Les requêtes sans clé continuent de fonctionner pour les points de terminaison publics, mais avec des limites de débit anonymes moins élevées.

Chaque réponse comporte un en-tête « X-Request-Id ». Si vous constatez un comportement inattendu, veuillez indiquer cet identifiant lorsque vous contactez le service d'assistance : cela nous permettra de retrouver votre requête exacte en quelques secondes.

Limites de débit

Les nouvelles clés commencent avec le niveau gratuit : 60 requêtes par minute et 5 000 par jour. Chaque réponse vous indique où vous en êtes grâce aux en-têtes X-RateLimit-Limit et X-RateLimit-Remaining ; si vous dépassez la limite, vous recevez une réponse 429 accompagnée d'un en-tête Retry-After vous indiquant quand réessayer.

Il existe des niveaux supérieurs pour les partenaires, attribués par l'équipe d'LeyApp. N'hésitez pas à nous contacter via le formulaire d'assistance si votre intégration nécessite davantage de marge de manœuvre.

Conserver ses clés en lieu sûr

Une clé d'API, c'est le mot de passe de votre intégration. Traitez-la comme tel :

• N'intégrez jamais de clé dans du code côté client, des applications mobiles ou des dépôts publics : toute personne capable de le lire pourrait épuiser votre limite de requêtes et effectuer des actions dans les limites de la clé.
• Utilisez une clé distincte pour chaque intégration ou environnement, afin de pouvoir en révoquer une sans affecter les autres.
• Répétez les clés que vous n'utilisez plus. La révocation est immédiate : les requêtes utilisant une clé révoquée échoueront dès l'appel suivant.
• Si une clé a pu faire l'objet d'une fuite, révoquez-la immédiatement dans Dashboard → Développeur et créez-en une nouvelle. La rotation s'effectue sans interruption de service : créez d'abord la nouvelle clé, déployez-la, puis révoquez l'ancienne.

Dépannage

J'obtiens une erreur 401 « Clé API non valide ».

Vérifiez que l'en-tête est bien « Authorization: Bearer leyk_... », sans espaces superflus, et que la clé n'a pas été révoquée. Notez que les jetons MCP (ley_...) disponibles dans Paramètres → Jetons « API » constituent des identifiants distincts et ne sont pas valides sur l'API REST.

Je reçois un code d'erreur 429 « Limite de requêtes dépassée ».

Vous avez atteint la limite par minute ou par jour de votre niveau. Respectez l'en-tête « Retry-After » et réessayez en appliquant un délai d'attente exponentiel. Si vous atteignez régulièrement le plafond quotidien, contactez-nous pour passer à un niveau supérieur.

Mes réservations d'essai n'apparaissent jamais nulle part.

C'est voulu : les clés de test permettent de tout valider, mais ne créent rien. Passez à une clé de production pour créer de véritables intentions de réservation.