Compte développeur
Un compte développeur vous permet de construire seul une intégration LexOpti : une fois votre accès validé par LexOpti, vous enregistrez vos applications, les essayez dans des bacs à sable, et demandez leur accès en production quand elles sont prêtes. LexOpti examine deux fois : chaque développeur avant qu’il ne commence, et chaque intégration avant qu’elle n’agisse pour une vraie structure (deux revues).
Types de compte
Section intitulée « Types de compte »LexOpti distingue deux types de compte. Le serveur fixe le type à la création du compte, et personne ne peut le changer ensuite.
| Compte professionnel | Compte développeur | |
|---|---|---|
| Qui | un membre d’une structure assujettie (cabinet d’avocats, étude notariale, cabinet d’expertise comptable, agence immobilière…) | le développeur d’une intégration partenaire |
| Structures | ses vraies structures, et les bacs à sable où il est invité | des bacs à sable uniquement, jamais une vraie structure |
| Console | l’application LexOpti | la console développeur, et l’application dans ses bacs à sable |
Ce sont deux identités séparées. Si vous utilisez déjà LexOpti en tant que professionnel, créez votre compte développeur avec une autre adresse e-mail : une adresse d’un type est refusée par l’autre. Chaque type a aussi sa connexion : un compte développeur se connecte depuis LexOpti Développeurs (/developer/login), un compte professionnel depuis la page de connexion de l’application (/login). Une fois votre code vérifié, chaque page envoie un compte de l’autre type vers la sienne, avec son adresse e-mail, où vous demandez un nouveau code.
Deux revues
Section intitulée « Deux revues »| Revue | Quand | Ce que LexOpti examine | Réponse |
|---|---|---|---|
| Revue d’accès | quand vous demandez votre compte développeur | qui vous êtes et pourquoi : votre société, son site web, l’intégration prévue | en général sous un jour ouvré, par e-mail |
| Revue de mise en production | quand votre intégration est prête, depuis la section Accès en production de son application | sa préparation et l’accord partenaire : le SIREN de la société, les adresses de redirection de production, les contacts sécurité et données personnelles, les conditions de l’API | en général sous un jour ouvré, par e-mail |
Entre les deux, vous développez librement dans vos bacs à sable. Un partenaire que LexOpti a déjà choisi passe la première revue par une invitation (invité par LexOpti) ; la revue de mise en production est la même pour tous.
Demander un compte développeur
Section intitulée « Demander un compte développeur »- Ouvrez « Créer un compte développeur » (aussi en haut de chaque page) et saisissez votre prénom, votre nom, votre adresse e-mail et votre société. Son site web et une courte description de l’intégration prévue (ce que fait votre logiciel, pour quels professionnels) sont facultatifs, mais facilitent l’examen. Les adresses jetables sont refusées.
- Saisissez le code à six chiffres que LexOpti vous envoie par e-mail : il vérifie votre adresse et vous connecte. Les connexions suivantes passent par le même code, depuis la connexion LexOpti Développeurs (Se connecter, en haut de chaque page), qui ouvre la console.
- L’équipe LexOpti examine votre demande, en général sous un jour ouvré. Tant qu’elle n’est pas validée, la console développeur affiche son état et ne crée ni application ni bac à sable. Vous recevez la décision par e-mail ; après un refus, la console affiche son motif et vous permet d’envoyer une nouvelle demande.
- Une fois votre accès validé, à votre première visite, la console développeur ouvre d’elle-même la création de votre application de test : donnez-lui ses adresses de redirection exactes. LexOpti n’en invente jamais, puisque les codes d’autorisation partiraient vers un hôte qui n’est pas le vôtre ; votre application de test et son bac à sable existent dès que vous les indiquez. LexOpti crée aussitôt son client OAuth confidentiel et son premier bac à sable, et affiche une seule fois son secret client : conservez-le dans le coffre de secrets de votre serveur. Pour une application mobile ou de bureau, choisissez le type natif : un client public, sans secret (applications mobiles et natives).
Une équipe compte trois applications au plus, et chaque application cinq bacs à sable au plus. Les créations de compte sont limitées par adresse IP et par boîte aux lettres : les alias d’une même boîte (nom+suffixe@, et les points d’une adresse Gmail) sont un seul compte développeur.
Invité par LexOpti
Section intitulée « Invité par LexOpti »Quand LexOpti a déjà choisi de travailler avec vous, l’équipe vous envoie plutôt une invitation : un e-mail à votre adresse avec un lien personnel vers la connexion LexOpti Développeurs. Connectez-vous avec cette même adresse : le code que LexOpti vous envoie par e-mail la vérifie, et votre accès développeur est validé aussitôt, sans demande à envoyer ni attente. Si l’adresse n’avait pas encore de compte, l’invitation l’a préparé. La console ouvre ensuite la création de votre première application, comme après une demande validée, et votre équipe porte le nom de la société de l’invitation.
Le lien sert une seule fois, pendant 14 jours, et pour l’adresse invitée seulement. Connecté avec une autre adresse, la console le dit et ne valide rien ; un lien expiré, déjà utilisé ou retiré dit qu’il ne fonctionne plus. Dans tous les cas, vous pouvez toujours envoyer une demande d’accès normale, ou demander une nouvelle invitation à l’équipe. Vos applications passent la même revue de mise en production que les autres.
La console développeur
Section intitulée « La console développeur »Pour chaque application, la console affiche et permet de modifier :
- son identifiant client, son identifiant de l’embarqué et, pour une application web, son secret client, renouvelé avec 24 heures de recouvrement ou sans délai après une fuite ;
- ses adresses de redirection exactes et les origines autorisées à embarquer ses composants, vérifiées comme le serveur les vérifie : modifiées tout de suite tant que l’application est dans ses bacs à sable, envoyées en revue une fois en production (l’équipe LexOpti applique les valeurs revues, comme pour l’accès en production) ;
- ses bacs à sable, que vous ouvrez dans LexOpti ou gérez depuis Gérer les bacs à sable ;
- les webhooks que votre serveur a enregistrés dans ses bacs à sable, avec un envoi de test ;
- les sessions embarquées des dernières 24 heures dans ses bacs à sable : quand votre serveur en a demandé une, pour quel membre et quelle page, et si l’iframe l’a ouverte ;
- son accès en production.
Journaux et webhooks
Section intitulée « Journaux et webhooks »Deux autres onglets de chaque application montrent son trafic, dans ses bacs à sable et, une fois approuvée, dans les vraies structures pour lesquelles elle travaille, jamais celui d’une autre application.
| Onglet | Montre | Filtres |
|---|---|---|
| Journaux | chaque requête à /v1 des 30 derniers jours faite avec l’un de ses jetons : méthode, chemin, statut HTTP, code du problème, durée, structure, bac à sable ou production, réseau d’origine, date, et son Request-Id |
résultat (réussie, échouée), méthode, structure, partie du chemin, dates, un Request-Id exact |
| Webhooks | ses points de réception dans chaque structure, et les envois des 30 derniers jours de chacun : type d’événement, statut, tentatives, statut HTTP et durée de la dernière réponse ; le détail d’un envoi montre le corps envoyé et chaque tentative, et Rejouer le renvoie avec le même webhook-id |
statut, type d’événement |
Ce que garde le journal est choisi pour qu’il ne contienne jamais ce qu’une requête transportait : aucun en-tête (donc ni Authorization ni jeton), aucun paramètre de requête, aucun corps de requête ou de réponse, l’adresse de l’appelant réduite à son réseau (/24 en IPv4, /48 en IPv6). Les entrées sont écrites après la réponse, sans jamais la ralentir, et supprimées au bout de 30 jours. Une requête refusée avant la vérification de son jeton (jeton absent ou invalide, 401) n’est pas journalisée, faute d’application à qui la montrer ; au-delà de la limite de débit, seul le premier 429 de chaque fenêtre d’une minute est journalisé, pas chaque refus. Un rejeu est refusé aussitôt tant que votre application n’a pas accès à la structure ou que le point de réception est désactivé. Un envoi rejoué ne part que tant que votre application a encore accès à la structure, comme tout envoi ; 30 envois rejoués au plus toutes les 10 minutes. Citez un Request-Id au support LexOpti : l’équipe voit les mêmes écrans, en lecture seule.
Confinée à ses bacs à sable
Section intitulée « Confinée à ses bacs à sable »Tant que son accès en production n’est pas accordé, une application agit uniquement pour ses propres bacs à sable. La page de consentement ne propose aucune autre structure, et /v1, les composants embarqués et le serveur MCP refusent tout jeton pour une autre structure, quelle que soit son expiration. Les bacs à sable ne consultent aucune vraie source, ne facturent rien et ne programment aucune vigilance.
Demander l’accès en production
Section intitulée « Demander l’accès en production »Quand votre intégration est prête, envoyez la demande depuis la section Accès en production de l’application. Elle demande :
- votre société, son SIREN et son site web ;
- le cas d’usage : ce que fait l’intégration, pour quels professionnels, et les données qu’elle conserve ;
- les adresses de redirection de production exactes, cinq au plus ;
- un contact sécurité et un contact données personnelles ;
- votre acceptation des conditions de l’API, dont la version datée est enregistrée avec la demande.
Le formulaire part de votre demande d’accès : votre société, son site web et le cas d’usage sont préremplis, à vérifier et compléter ; le SIREN, les adresses de redirection de production, les contacts et les conditions sont propres à cette revue.
Une seule demande par application est examinée à la fois. L’équipe LexOpti l’accorde ou la refuse, avec un motif, en général sous un jour ouvré, et vous recevez la décision par e-mail. L’accord lève le confinement et ajoute les adresses de redirection de production à l’application ; une application refusée reste dans ses bacs à sable, et vous pouvez envoyer une nouvelle demande. Un éventuel contrat partenaire se signe en dehors de la console.
Votre équipe
Section intitulée « Votre équipe »Un éditeur est une société, pas une personne : la console développeur fonctionne comme une structure. La validation de votre accès ouvre votre équipe, nommée d’après la société de votre demande, dont vous êtes propriétaire. Depuis Équipe, un propriétaire invite ses collègues par e-mail, avec un rôle (membre, ou propriétaire pour qu’ils invitent à leur tour) : l’invité reçoit un e-mail, se connecte avec cette adresse (son compte développeur est créé pour lui s’il n’en a pas) et rejoint l’équipe à son premier code, sans rien demander à LexOpti. Il accède aussitôt aux mêmes applications (identifiants, redirections, origines, webhooks, journaux, demandes d’accès en production, relevé partenaire) et aux mêmes bacs à sable, dont il devient propriétaire, et peut choisir le bac à sable de l’équipe au consentement.
Une invitation est valable sept jours ; une équipe compte dix places au plus (membres et invitations en cours), et trois applications au plus, quel que soit le nombre de ses membres. Un compte développeur n’appartient qu’à une équipe : un collègue déjà dans la sienne ne rejoint pas la vôtre. Le renommage, la réinitialisation et la suppression d’un bac à sable restent à celui qui l’a créé.
Vos données
Section intitulée « Vos données »Un compte développeur conserve votre adresse e-mail, votre nom et ce que dit votre demande d’accès (votre société, et son site web et l’intégration prévue si vous les avez donnés). Un compte sans connexion pendant deux ans est supprimé avec ses applications et ses bacs à sable, après un avertissement envoyé par e-mail 30 jours avant ; une seule connexion suffit à le conserver. Un compte dont une application a reçu son accès en production n’est jamais supprimé automatiquement : de vraies structures peuvent en dépendre, et l’équipe LexOpti décide avec vous. Les demandes d’accès en production, avec leur SIREN, la version des conditions et la décision, sont conservées après la suppression du compte. Pour exercer vos droits, écrivez à contact@lexopti.com.