Aller au contenu

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}/checks lance 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 les checks de la réponse ; celles des parties suivent le status du dossier. Idempotency-Key exigée ; incomplete_identity, quota_exceeded, subscription_inactive et case_closed le refusent avant tout lancement. Le démarrage rapide lance désormais son dossier ainsi. Le SDK ajoute cases.launchChecks.

  • Préremplir la connexion et l’inscription : le paramètre lexopti_hint de 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ête X-LexOpti-Acting-User, y compris pour les écrans embarqués, et chaque trace dit que l’identité est affirmée par votre application. GET et DELETE /v1/members/enrolments, événements member.enrolled et member.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, ou null), GET /v1/clients/{id}/preliminary-screening renvoie 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énement client.preliminary_screening_completed signale un résultat terminé ou changé. Votre application décide des autres analyses : POST /v1/clients/{id}/preliminary-screening (lexopti:write, une Idempotency-Key, 202) demande l’analyse de tout client que votre jeton atteint, un client créé dans LexOpti et lié à votre référence compris (409 preliminary_screening_pending pendant qu’une analyse est en cours, 503 preliminary_screening_unavailable sans 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 ajoute clients.getPreliminaryScreening et clients.requestPreliminaryScreening. Dans un bac à sable, SANCTION donne une correspondance possible et ERREUR un é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 Authorization lit 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 comme France répond désormais validation_failed, alors qu’il était enregistré sans jamais correspondre lors de l’analyse. nationalities contient 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.status et de alert.change, et dit partout « dossier » pour case, 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/firms et 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/firms prépare une structure (une firm) 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, expired après 30 jours, voided quand le SIREN a rejoint LexOpti autrement), POST /v1/firms/{id}/claim-link renouvelle son lien. Un SIREN déjà client répond firm_exists. Ajouter lexopti_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/cases crée un dossier pour des clients existants (par identifiant ou par votre external_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_checks lance ses analyses avec elle quand cela ne coûte rien de plus. POST /v1/cases/preview donne d’abord le coût, sans rien écrire. Idempotency-Key exigé ; quota_exceeded, subscription_inactive, external_ref_conflict et validation_failed la refusent avant toute écriture. Le dossier ajoute types (toutes ses natures ; type est la première). Le serveur MCP ajoute lexopti_preview_case et lexopti_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_exhausted laisse désormais le bac à sable sans crédit (ce qui coûte répond quota_exceeded) jusqu’au nouveau déclencheur quota_restored ou à 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/checks accepte un case_id facultatif, un client sans dossier ouvert reçoit son dossier de relation d’affaires, et plusieurs dossiers ouverts répondent dossier_required avec leur liste. Un refus est quota_exceeded (les crédits ne peuvent pas la payer) ou subscription_inactive (aucune offre ne court). GET /v1/usage montre désormais les crédits et les dossiers (credits, dossiers, subscription_active), et quota.exhausted est envoyé quand le dernier crédit est dépensé, sans period. 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_credits remplace over_quota).

  • Déclencheurs de test des bacs à sable : POST /v1/sandbox/triggers produit 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 403 sandbox_required. Le SDK ajoute sandboxTriggers.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 à /v1 de chaque application sur 30 jours (filtres, recherche par Request-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, sinon quota_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. Le prefill de <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}/report sert le rapport du dossier en PDF par une URL signée valable 5 minutes, avec sa version (aussi ETag) et le sha256 du 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}/documents liste 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.inactive et access.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 et disabled_reason en x-extensible-enum : de nouvelles valeurs peuvent venir, ignorez celles que vous ne traitez pas.

  • SDK, types d’événements plus récents : webhooks.verify accepte un envoi d’un type d’événement qu’il ne connaît pas encore (access.revoked sur une version plus ancienne, tout type que LexOpti ajoutera) et rend son type tel qu’envoyé : un envoi authentique n’échoue jamais à la vérification. WebhookEventType le 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_id et external_ref, votre identifiant de cette personne ou société, défini par PUT /v1/cases/{id}/parties/{party_id}/external-ref et retrouvé par GET /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.1 ou http://[::1] sur tout port, un schéma à usage privé en domaine inversé ou une URI HTTPS revendiquée, jamais localhost. 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 à /v1 avec pagination et Idempotency-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 /v1 porte un en-tête Request-Id, généré par LexOpti, et chaque problème le même identifiant dans request_id. Citez-le au support LexOpti (identifiants de requête).

  • Dossiers enrichies : GET /v1/cases et GET /v1/cases/{id} ajoutent clients (chaque client avec votre référence, main pour le principal), parties (les autres parties, avec leur role, codes par profession), risk_level (validé par un membre), classification_state et pending_alert_count. Le filtre client_id de GET /v1/cases trouve aussi les dossiers dont le client n’est pas le principal. Deux nouveaux événements : case.created et case.risk_level_changed (lire les dossiers d’un client). L’outil MCP lexopti_get_case_summary renvoie les mêmes champs.

  • Classification, en lecture seule : GET /v1/clients/{id}/classification et GET /v1/cases/{id}/classification renvoient la classification TRACFIN telle qu’elle est enregistrée : state, score, level, validated_at, validated_by, les réponses par identifiant de question et missing_answers. Un nouvel événement, classification.validated, est envoyé à chaque validation par un membre (lire la classification d’un client). Le serveur MCP ajoute lexopti_get_classification.

  • Références partenaires : les clients et les dossiers portent external_ref, le propre identifiant de votre application (null sans référence, et jamais celui d’une autre application). Définissez-le avec POST /v1/clients ou PUT /v1/clients/{id}/external-ref et PUT /v1/cases/{id}/external-ref, retirez-le avec DELETE sur les mêmes chemins, et retrouvez un enregistrement avec le filtre external_ref de GET /v1/clients et GET /v1/cases. Une référence déjà utilisée répond 409 external_ref_conflict. Les données des événements et des webhooks ajoutent client_external_ref et case_external_ref (vos propres identifiants).

  • Listes embarquées et LexOpti lui-même : POST /v1/embed-sessions ouvre désormais les composants clients, cases et app, 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, path pour l’écran sur lequel il s’ouvre). Une liste garde les clés features de la page que ses lignes ouvrent, app les onglets des deux pages ; edit porte aussi leurs entrées de création (les listes et LexOpti lui-même).

  • Un nouveau client depuis votre page : POST /v1/embed-sessions ouvre désormais le composant new-client, pour <lexopti-new-client> : le formulaire de nouveau client de LexOpti, rempli depuis la propriété prefill de votre page (la forme de POST /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-ref de l’élément lors de sa création, comme external_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énement lexopti-client-created ({ clientId, externalRef }) est désormais envoyé (un nouveau client depuis votre page).

  • Un nouveau dossier depuis votre page : POST /v1/embed-sessions ouvre désormais le composant new-case, pour <lexopti-new-case> : l’écran « Nouveau dossier » de LexOpti lui-même, rempli depuis la propriété prefill de 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-ref de 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 (avec edit). L’événement lexopti-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-sessions et 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-sessions répond 403 sandbox_required, un nouveau code d’erreur.

  • SDK : webhooks.verify accepte aussi webhook.test, l’envoi que déclenche POST /v1/webhook-endpoints/{id}/test, qu’il refusait. Son résultat, WebhookEvent, type désormais type comme les types d’événements ou "webhook.test" : un switch exhaustif sur event.type doit 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).