Historique
Première version de /v1 : organisation, consommation, clients, analyses, dossiers, alertes, événements, points de réception webhook, sessions embarquées et liens profonds.
-
Lancer les analyses d’un dossier :
POST /v1/cases/{id}/checkslance toutes les analyses d’un dossier en un seul appel, comme le bouton « Lancer les analyses » de LexOpti sur la page du dossier : chaque client du dossier avec ses personnes liées, et les parties du dossier, facturées au dossier comme l’application le facture. Le lancement de chaque client est une analyse de votre application, listée dans leschecksde la réponse ; celles des parties suivent lestatusdu dossier.Idempotency-Keyexigée ;incomplete_identity,quota_exceeded,subscription_inactiveetcase_closedle refusent avant tout lancement. Le démarrage rapide lance désormais son dossier ainsi. Le SDK ajoutecases.launchChecks. -
Préremplir la connexion et l’inscription : le paramètre
lexopti_hintde la demande d’autorisation (le SDK l’encode,encodePartnerHint) porte l’adresse, le nom et la structure du membre ; la connexion démarre avec son adresse, l’inscription avec le reste, chaque champ restant à vérifier par le membre ; le SIREN est prérempli mais jamais verrouillé (connecter un membre). -
Enrôler vos membres :
POST /v1/members/enrolments(propriétaire ou administrateur de la structure, application installée pour la structure) crée le compte d’une personne de la structure et décide son appartenance ; en mode nominatif, elle n’a plus que son code à saisir depuis votre bouton ; en mode délégué, activé par LexOpti à la demande de la structure, elle n’a rien à faire : votre logiciel nomme le membre qui agit avec l’en-têteX-LexOpti-Acting-User, y compris pour les écrans embarqués, et chaque trace dit que l’identité est affirmée par votre application.GETetDELETE /v1/members/enrolments, événementsmember.enrolledetmember.joined(enrôler vos membres). -
Analyse préliminaire : chaque client que votre application crée par l’API reçoit une analyse gratuite sur les listes officielles de gels et de sanctions que LexOpti intègre elle-même (le registre national des gels, la liste des sanctions financières de l’UE, la liste OFAC SDN des États-Unis), renouvelée gratuitement à chaque nouvelle publication de ces listes tant que l’organisation a une offre et que le client n’est pas en vigilance continue (jamais dans un bac à sable). Les ressources client ajoutent
preliminary_screening(status,pending,outcome,match_count,screened_at,checked_at,last_error, ounull),GET /v1/clients/{id}/preliminary-screeningrenvoie le résultat courant et la dernière demande (les listes consultées avec leurs dates de publication et leur attribution, les correspondances avec leurs références et liens officiels), et le nouvel événementclient.preliminary_screening_completedsignale un résultat terminé ou changé. Votre application décide des autres analyses :POST /v1/clients/{id}/preliminary-screening(lexopti:write, uneIdempotency-Key, 202) demande l’analyse de tout client que votre jeton atteint, un client créé dans LexOpti et lié à votre référence compris (409preliminary_screening_pendingpendant qu’une analyse est en cours, 503preliminary_screening_unavailablesans la fonctionnalité) ; lier un client ou modifier un client que votre application n’a pas créé ne demande rien, et un client qu’elle a créé par l’API est analysé de nouveau quand un champ d’identité analysé change. Le résultat ne parvient qu’à votre application : les membres de l’organisation n’en voient rien dans LexOpti. Le SDK ajouteclients.getPreliminaryScreeningetclients.requestPreliminaryScreening. Dans un bac à sable,SANCTIONdonne une correspondance possible etERREURun échec, aussitôt (analyse préliminaire). -
Champs d’identité, documentés et vérifiés : chaque champ de requête de la référence de l’API dit désormais ce qu’il est, son format et un exemple, et chaque requête montre un corps prêt à copier, aussi dans ses exemples curl et PHP (dont l’en-tête curl
Authorizationlit désormais la variable$LEXOPTI_TOKEN). Une nouvelle page liste les champs d’identité et ce qu’une analyse exige (champs d’identité). Les pays (birth_country,nationalities,registration_country,address.country) doivent être des codes ISO 3166-1 alpha-2, mis en majuscules par LexOpti, comme le serveur MCP et les composants embarqués l’exigeaient déjà : un nom commeFrancerépond désormaisvalidation_failed, alors qu’il était enregistré sans jamais correspondre lors de l’analyse.nationalitiescontient 10 codes au plus, et les champs texte d’identité 255 caractères. -
Glossaire et référence en langage clair : un glossaire explique les termes métier (niveaux de vigilance et de risque, évaluation de risque et ses axes, PPE, bénéficiaire effectif, dossier, crédits, analyse préliminaire, enrôlement et mode délégué…). La référence réécrit les descriptions qui les supposaient connus, renvoie au glossaire, explique chaque valeur de
case.statuset dealert.change, et dit partout « dossier » pourcase, comme les écrans de LexOpti. Documentation seulement : aucun champ ni comportement ne change. -
Toutes les professions dans la documentation : le portail et la référence décrivent LexOpti pour toutes les professions qu’elle sert, avocats, notaires, experts-comptables, agents immobiliers et autres professionnels assujettis : ils parlent d’organisations (ou structures) et de membres, expliquent ce qui dépend de la profession (les mots des écrans de LexOpti, les natures des dossiers, les rôles des parties, le questionnaire : toutes les professions, une seule API), et leurs exemples varient les professions. Documentation seulement :
firm,/v1/firmset tous les autres identifiants restent tels quels. -
Créer la structure d’un nouveau client : avec le jeton propre à votre application (client credentials, scope
lexopti:firms, seulement pour une application autorisée en production),POST /v1/firmsprépare une structure (unefirm) que son responsable réclame : LexOpti lui envoie par e-mail un lien d’activation à usage unique (7 jours), qui ouvre son inscription normale avec la structure remplie, chaque vérification habituelle portant sur ce que le responsable confirme ; rien n’existe dans LexOpti avant.GET /v1/firms/{id}la suit (pending,claimed,expiredaprès 30 jours,voidedquand le SIREN a rejoint LexOpti autrement),POST /v1/firms/{id}/claim-linkrenouvelle son lien. Un SIREN déjà client répondfirm_exists. Ajouterlexopti_claimà votre autorisation ramène le responsable connecté. La structure est attribuée à votre application dès que son offre démarre (créer la structure d’un nouveau client). -
Créer un dossier :
POST /v1/casescrée un dossier pour des clients existants (par identifiant ou par votreexternal_ref), avec ses natures parmi celles de la profession (natures des dossiers), ses parties (personnes ou sociétés, leur rôle et votre référence) et votre référence du dossier, comme l’écran « Nouveau dossier » de LexOpti et facturée comme il la facture ;launch_checkslance ses analyses avec elle quand cela ne coûte rien de plus.POST /v1/cases/previewdonne d’abord le coût, sans rien écrire.Idempotency-Keyexigé ;quota_exceeded,subscription_inactive,external_ref_conflictetvalidation_failedla refusent avant toute écriture. Le dossier ajoutetypes(toutes ses natures ;typeest la première). Le serveur MCP ajoutelexopti_preview_caseetlexopti_create_case: le membre confirme le coût dans le formulaire de LexOpti ou, sans formulaire, crée le dossier proposé dans LexOpti (créer un dossier depuis votre fiche). -
Crédits du bac à sable, jamais prélevés : les dossiers, analyses et parties d’un bac à sable sont chiffrés et facturés comme ceux d’une vraie structure, mais ses 1 000 crédits gratuits ne sont jamais prélevés et ses mouvements restent vides. Le déclencheur
quota_exhaustedlaisse désormais le bac à sable sans crédit (ce qui coûte répondquota_exceeded) jusqu’au nouveau déclencheurquota_restoredou à une réinitialisation (déclencheurs de test). -
Programme partenaires : une structure créée après être passée par votre application (le parcours OAuth d’un membre sans compte, ou votre lien de parrainage
/login?tab=sign-up&partner=<identifiant public>) lui est attribuée, premier partenaire seulement, nouvelles structures seulement, jamais un bac à sable. La console développeur ajoute un onglet Relevé partenaire : les structures apportées, leur date d’attribution et les montants agrégés de leurs factures payées, hors taxes, avec la commission de votre accord (programme partenaires). -
Un membre sans compte : la page de connexion de LexOpti propose de créer un compte, et l’autorisation lancée par votre logiciel reprend une fois l’inscription terminée (45 minutes, même navigateur), jusqu’à votre adresse de retour avec le code et votre
state. Votre demande ne change pas (un membre sans compte). -
Facturation au dossier : une analyse est facturée au dossier du client comme LexOpti la facture (un crédit ouvre un dossier de cinq personnes ou sociétés au plus pendant douze mois) :
POST /v1/checksaccepte uncase_idfacultatif, un client sans dossier ouvert reçoit son dossier de relation d’affaires, et plusieurs dossiers ouverts répondentdossier_requiredavec leur liste. Un refus estquota_exceeded(les crédits ne peuvent pas la payer) ousubscription_inactive(aucune offre ne court).GET /v1/usagemontre désormais les crédits et les dossiers (credits,dossiers,subscription_active), etquota.exhaustedest envoyé quand le dernier crédit est dépensé, sansperiod. Un bac à sable a 1 000 crédits gratuits, rendus par une réinitialisation. L’aperçu du MCP montre le dossier et ses crédits (insufficient_creditsremplaceover_quota). -
Déclencheurs de test des bacs à sable :
POST /v1/sandbox/triggersproduit dans un bac à sable une alerte de vigilance, un changement de niveau de vigilance, le dernier crédit dépensé ou un accès révoqué, par les mêmes écritures que dans une vraie structure, si bien que vos points de réception reçoivent les webhooks mêmes de la production. Ailleurs, il répond 403sandbox_required. Le SDK ajoutesandboxTriggers.create(déclencheurs de test). -
Données d’exemple des bacs à sable : un nouveau bac à sable, et chaque bac à sable après une réinitialisation, contient des clients et des dossiers d’exemple pour chaque entrée magique, déjà analysés, avec leurs parties et leurs alertes (données d’exemple).
-
Journaux et webhooks dans la console développeur : les requêtes à
/v1de chaque application sur 30 jours (filtres, recherche parRequest-Id) et ses envois de webhooks dans chaque organisation, avec chaque tentative, le corps envoyé et Rejouer (journaux et webhooks). -
Modifier un client :
PATCH /v1/clients/{id}modifie l’identité d’une personne ou d’une société avec les règles de l’application (un client analysé garde ses champs obligatoires,incomplete_identity; un champ analysé modifié en vigilance continue relance son analyse, une unité de quota, sinonquota_exceeded). Il complète une identité qu’une analyse a refusée.lexopti:write, idempotent par nature (le même corps ne change rien). Le type, les niveaux, la vigilance et la référence ne s’y modifient pas. Leprefillde<lexopti-client>propose désormais des modifications du client qu’il affiche, vérifiées et enregistrées par le membre (intégration embarquée). -
Rapport et documents :
GET /v1/cases/{id}/reportsert le rapport du dossier en PDF par une URL signée valable 5 minutes, avec saversion(aussiETag) et lesha256du fichier : la version destinée aux partenaires, qui ne contient jamais l’axe du soupçon et calcule ses scores sans lui.GET /v1/cases/{id}/documentsliste les documents du dossier, chacun avec une URL signée.lexopti:read. -
Catalogue des webhooks : nouveaux événements
client.created,client.updated,client.vigilance_level_changed,case.updated,report.generated,decision.pending,quota.exhausted,subscription.inactiveetaccess.revoked, le dernier envoi à vos points de réception quand votre application perd l’accès à une organisation, qui les désactive ensuite (disabled_reason: access_revoked) au lieu de s’arrêter en silence (événements). Le document OpenAPI déclare les types d’événements etdisabled_reasonenx-extensible-enum: de nouvelles valeurs peuvent venir, ignorez celles que vous ne traitez pas. -
SDK, types d’événements plus récents :
webhooks.verifyaccepte un envoi d’un type d’événement qu’il ne connaît pas encore (access.revokedsur une version plus ancienne, tout type que LexOpti ajoutera) et rend sontypetel qu’envoyé : un envoi authentique n’échoue jamais à la vérification.WebhookEventTypele type (les types connus,webhook.test, ou toute chaîne) : traitez les types que vous connaissez et ignorez les autres. -
Références des parties : les parties d’un dossier portent
entity_idetexternal_ref, votre identifiant de cette personne ou société, défini parPUT /v1/cases/{id}/parties/{party_id}/external-refet retrouvé parGET /v1/cases?party_external_ref=…(vos propres identifiants). -
Applications mobiles et natives : une application peut être enregistrée comme application native (RFC 8252), un client public sans secret, PKCE exigé, redirigé vers
http://127.0.0.1ouhttp://[::1]sur tout port, un schéma à usage privé en domaine inversé ou une URI HTTPS revendiquée, jamaislocalhost. Un nouveau guide le décrit, ainsi que les composants embarqués dans une webview (applications mobiles et natives). -
Exemples PHP : du PHP exécutable pour le parcours OAuth avec rotation du jeton de rafraîchissement, un appel à
/v1avec pagination etIdempotency-Key, et la vérification des webhooks, exécutés contre l’API dans les tests de LexOpti (exemples PHP). -
Identifiants de requête : chaque réponse de
/v1porte un en-têteRequest-Id, généré par LexOpti, et chaque problème le même identifiant dansrequest_id. Citez-le au support LexOpti (identifiants de requête). -
Dossiers enrichies :
GET /v1/casesetGET /v1/cases/{id}ajoutentclients(chaque client avec votre référence,mainpour le principal),parties(les autres parties, avec leurrole, codes par profession),risk_level(validé par un membre),classification_stateetpending_alert_count. Le filtreclient_iddeGET /v1/casestrouve aussi les dossiers dont le client n’est pas le principal. Deux nouveaux événements :case.createdetcase.risk_level_changed(lire les dossiers d’un client). L’outil MCPlexopti_get_case_summaryrenvoie les mêmes champs. -
Classification, en lecture seule :
GET /v1/clients/{id}/classificationetGET /v1/cases/{id}/classificationrenvoient la classification TRACFIN telle qu’elle est enregistrée :state,score,level,validated_at,validated_by, les réponses par identifiant de question etmissing_answers. Un nouvel événement,classification.validated, est envoyé à chaque validation par un membre (lire la classification d’un client). Le serveur MCP ajoutelexopti_get_classification. -
Références partenaires : les clients et les dossiers portent
external_ref, le propre identifiant de votre application (nullsans référence, et jamais celui d’une autre application). Définissez-le avecPOST /v1/clientsouPUT /v1/clients/{id}/external-refetPUT /v1/cases/{id}/external-ref, retirez-le avecDELETEsur les mêmes chemins, et retrouvez un enregistrement avec le filtreexternal_refdeGET /v1/clientsetGET /v1/cases. Une référence déjà utilisée répond 409external_ref_conflict. Les données des événements et des webhooks ajoutentclient_external_refetcase_external_ref(vos propres identifiants). -
Listes embarquées et LexOpti lui-même :
POST /v1/embed-sessionsouvre désormais les composantsclients,casesetapp, pour<lexopti-clients>,<lexopti-cases>et<lexopti-app>(tableau de bord, listes, pages des clients et des dossiers et formulaire de nouveau client, dans la navigation réduite de LexOpti,pathpour l’écran sur lequel il s’ouvre). Une liste garde les clésfeaturesde la page que ses lignes ouvrent,apples onglets des deux pages ;editporte aussi leurs entrées de création (les listes et LexOpti lui-même). -
Un nouveau client depuis votre page :
POST /v1/embed-sessionsouvre désormais le composantnew-client, pour<lexopti-new-client>: le formulaire de nouveau client de LexOpti, rempli depuis la propriétéprefillde votre page (la forme dePOST /v1/clients, chaque champ vérifié, jamais dans une URL), le client créé seulement quand le membre clique sur créer et lié à l’external-refde l’élément lors de sa création, commeexternal_ref; un identifiant déjà lié affiche son client à la place.<lexopti-client external-ref="…">affiche le client que votre identifiant désigne, ou propose de le créer. L’événementlexopti-client-created({ clientId, externalRef }) est désormais envoyé (un nouveau client depuis votre page). -
Un nouveau dossier depuis votre page :
POST /v1/embed-sessionsouvre désormais le composantnew-case, pour<lexopti-new-case>: l’écran « Nouveau dossier » de LexOpti lui-même, rempli depuis la propriétéprefillde votre page (son titre, ses natures parmi celles de la profession et ses parties, chacune un client existant par son identifiant ou votre référence, ou une identité à créer, avec son rôle ; chaque champ vérifié, jamais dans une URL), le dossier créé seulement quand le membre clique sur créer et lié à l’external-refde l’élément dans sa création ; un identifiant déjà lié affiche son dossier à la place.<lexopti-case external-ref="…">affiche le dossier que votre identifiant désigne, ou propose de le créer.<lexopti-app>ouvre en lui son formulaire de nouveau dossier (avecedit). L’événementlexopti-case-created({ caseId, externalRef }) est désormais envoyé (un nouveau dossier depuis votre page). -
Atelier en direct : l’atelier des composants embarqués affiche désormais le composant choisi lui-même, dans l’un de vos bacs à sable : autorisez le portail comme dans la référence de l’API, et la page ouvre chaque session avec
POST /v1/embed-sessionset votre jeton, comme le ferait votre serveur, et consigne les événements. L’application du portail n’embarque que depuis ses propres pages et que dans des structures bac à sable : ailleurs,POST /v1/embed-sessionsrépond 403sandbox_required, un nouveau code d’erreur. -
SDK :
webhooks.verifyaccepte aussiwebhook.test, l’envoi que déclenchePOST /v1/webhook-endpoints/{id}/test, qu’il refusait. Son résultat,WebhookEvent, type désormaistypecomme les types d’événements ou"webhook.test": unswitchexhaustif surevent.typedoit traiter le test. -
Bacs à sable : jusqu’à 5 par application, chacun nommé et avec la profession qu’il simule. Une réinitialisation vide désormais le bac à sable sur place : l’identifiant de l’organisation, votre consentement, vos jetons et vos points de réception de webhooks restent, vous ne reconnectez rien ; les anciens identifiants de client, de dossier et de contrôle répondent 404, les envois en attente sont annulés, et un bac à sable se réinitialise au plus une fois par minute (bac à sable).