Aller au contenu

Démarrage rapide

Dans ce tutoriel, vous reliez votre application à votre organisation bac à sable, ouvrez le dossier d’une vente immobilière avec ses deux clients, un acquéreur nommé Camille Durand SANCTION et un vendeur, lancez leurs analyses, et finissez par lire les trois alertes de sanctions que l’acquéreur a levées. Il vous faut un terminal et un navigateur, puis, pour le code, Node.js 20 ou plus récent, PHP 8.1 ou plus récent, ou curl seul. Les trois premières étapes se font dans le terminal, quel que soit le langage choisi.

Il vous faut ce que votre compte développeur vous donne quand vous créez votre application dans sa console (ou LexOpti, quand il l’enregistre pour vous) :

  • un compte LexOpti, créé avec l’adresse e-mail avec laquelle vous développez, propriétaire d’une organisation bac à sable ;
  • un client OAuth : son client_id, son client_secret (affiché une seule fois) et l’une de ses URI de redirection enregistrées. Ce tutoriel l’écrit https://crm.example.com/oauth/callback : utilisez la vôtre à la place.

Les comptes développeur et professionnel sont distincts : si vous utilisez déjà LexOpti en tant que professionnel, demandez-les avec une autre adresse e-mail.

LexOpti exige toujours PKCE. Dans votre terminal, gardez les identifiants de votre client et tirez un vérificateur aléatoire, puis calculez son challenge :

Fenêtre de terminal
export CLIENT_ID=YOUR_CLIENT_ID
export CLIENT_SECRET=YOUR_CLIENT_SECRET
export CODE_VERIFIER=$(openssl rand -base64 32 | tr '+/' '-_' | tr -d '=')
export CODE_CHALLENGE=$(printf %s "$CODE_VERIFIER" | openssl dgst -sha256 -binary | openssl base64 | tr '+/' '-_' | tr -d '=')
echo "$CODE_CHALLENGE"

La dernière commande affiche un challenge de 43 caractères. Gardez ce terminal ouvert : les étapes suivantes utilisent ces variables.

Ouvrez cette adresse dans votre navigateur, avec votre client_id, votre URI de redirection et le challenge que vous venez d’afficher :

https://app.lexopti.com/api/auth/oauth2/authorize?response_type=code
&client_id=YOUR_CLIENT_ID
&redirect_uri=https://crm.example.com/oauth/callback
&code_challenge=YOUR_CODE_CHALLENGE&code_challenge_method=S256
&scope=openid%20offline_access%20lexopti:read%20lexopti:write
&resource=https://app.lexopti.com/v1&state=YOUR_STATE

Connectez-vous avec votre compte développeur, choisissez votre organisation bac à sable et consentez. LexOpti renvoie votre navigateur vers votre URI de redirection avec code et state dans l’adresse. Votre rappel n’a pas besoin d’exister encore : copiez la valeur de code depuis la barre d’adresse, et utilisez-la aussitôt, car un code ne vaut que peu de temps et une seule fois.

Fenêtre de terminal
export CODE=THE_CODE_YOU_COPIED
Fenêtre de terminal
curl https://app.lexopti.com/api/auth/oauth2/token \
-u "$CLIENT_ID:$CLIENT_SECRET" \
-d grant_type=authorization_code \
-d code="$CODE" \
-d code_verifier="$CODE_VERIFIER" \
-d redirect_uri=https://crm.example.com/oauth/callback \
-d resource=https://app.lexopti.com/v1

LexOpti répond un objet JSON avec un access_token, valable 15 minutes (expires_in: 900), et un refresh_token. Gardez le jeton d’accès pour la suite du tutoriel :

Fenêtre de terminal
export LEXOPTI_ACCESS_TOKEN=THE_ACCESS_TOKEN
curl -H "Authorization: Bearer $LEXOPTI_ACCESS_TOKEN" https://app.lexopti.com/v1/organization

La réponse décrit votre organisation bac à sable, avec "sandbox": true : votre application agit désormais pour vous dans celle-ci.

Écrivez les étapes suivantes dans le langage de votre choix : les onglets montrent chacune en TypeScript avec le SDK, en PHP avec son extension curl et sans bibliothèque, ou avec curl dans le même terminal.

Dans LexOpti, une analyse se fait toujours dans un dossier (case dans l’API) : l’affaire, la mission ou l’opération pour laquelle elle est menée, avec sa nature et ses clients. Ici le dossier est une vente immobilière, un exemple que traitent bien des professions, de nature vente_immobiliere, pour deux clients, l’acquéreur et le vendeur. Un dossier nomme des clients existants : vous les créez d’abord (POST /v1/clients), puis le dossier (POST /v1/cases). SANCTION dans le nom de l’acquéreur donne un résultat de sanctions déterministe dans le bac à sable ; le nom du vendeur est propre. Chaque création envoie une Idempotency-Key (le SDK l’ajoute), pour qu’une nouvelle tentative ne crée jamais une seconde ressource.

Les natures dépendent de la profession de votre bac à sable : les avocats et les agents immobiliers proposent vente_immobiliere ; pour une autre profession, choisissez l’une des siennes (le bac à sable d’un expert-comptable peut prendre cession_parts_actions, par exemple), ou custom avec un type_label, que toutes les professions proposent, notaires compris.

Dans un nouveau dossier, installez le SDK :

Fenêtre de terminal
npm install @lexopti/sdk

Enregistrez ce script sous quickstart.mts :

import { createLexOptiClient } from "@lexopti/sdk";
const lexopti = createLexOptiClient({
accessToken: () => process.env.LEXOPTI_ACCESS_TOKEN ?? "",
});
const organization = await lexopti.organization.get();
const buyer = await lexopti.clients.create({
type: "person",
person: {
first_name: "Camille",
last_name: "Durand SANCTION",
birth_date: "1980-02-01",
nationalities: ["FR"],
},
});
const seller = await lexopti.clients.create({
type: "person",
person: {
first_name: "Louis",
last_name: "Martin",
birth_date: "1975-06-15",
nationalities: ["FR"],
},
});
const sale = await lexopti.cases.create({
types: ["vente_immobiliere"],
clients: [{ id: buyer.id }, { id: seller.id }],
label: "Vente 12 rue des Lilas",
});
console.log(organization.sandbox, sale.id, sale.type);

Lancez-le depuis le terminal où LEXOPTI_ACCESS_TOKEN est défini :

Fenêtre de terminal
npx tsx quickstart.mts

Le script affiche true (votre organisation est un bac à sable), l’identifiant du dossier et sa nature vente_immobiliere ; avec curl, la réponse est le dossier lui-même (201). Rien n’est encore analysé : son pending_alert_count est 0.

Un seul appel lance les analyses du dossier, comme le bouton « Lancer les analyses » de LexOpti sur la page du dossier : tous les clients et parties du dossier sont passés au crible des sources, et chaque client reçoit une analyse qui est la vôtre. (Pour créer un dossier et lancer ses analyses en un seul appel, envoyez launch_checks: true avec POST /v1/cases.)

Ajoutez ces lignes à la fin de quickstart.mts, puis relancez le script :

const launch = await lexopti.cases.launchChecks({ id: sale.id });
console.log(
launch.checks.length,
launch.checks.map((check) => check.status).join(" ")
);

Un script relancé crée un second dossier, avec deux nouveaux clients du bac à sable. La nouvelle ligne donne le nombre d’analyses lancées, une par client du dossier, et le statut de chacune ; avec curl, la réponse est le dossier lui-même (202), avec ses checks. Une analyse est asynchrone : votre intégration la suit, ou attend check.completed.

Ajoutez ces lignes à la fin de quickstart.mts, puis relancez le script :

const checks = await Promise.all(
launch.checks.map((check) => lexopti.checks.get({ id: check.id }))
);
const settled = await lexopti.cases.get({ id: sale.id });
const buyerAlerts = await lexopti.alerts.list({ client_id: buyer.id });
const sellerAlerts = await lexopti.alerts.list({ client_id: seller.id });
console.log(
checks.map((check) => check.status).join(" "),
settled.pending_alert_count,
sellerAlerts.data.length
);
for (const alert of buyerAlerts.data) {
console.log(alert.status, alert.source);
}

Cette fois, vous lisez les deux analyses completed, les trois alertes que le dossier compte pour l’examen d’un membre (pending_alert_count), et aucune pour le vendeur ; puis les alertes de l’acquéreur, pending, une par source de sanctions : international_sanctions, eu_sanctions et french_asset_freezes, dans un ordre quelconque. Un membre les examine dans LexOpti, sur le dossier.

Vous avez autorisé une application, ouvert un dossier avec ses clients par l’API, lancé ses analyses et lu ce qu’elles ont trouvé, comme un membre le verrait dans LexOpti.