API développeurs
le contrôle des sanctions dans vos propres systèmes
Créez des clés API, appelez l’API Sanctions depuis vos propres outils d’entrée en relation et de KYC, et suivez chaque requête et sa consommation dans la console développeurs.
Appuyez sur lecture pour commencer · Espace met en pause · ← → recule ou avance de 5 secondes · C affiche ou masque les sous-titres
Chapitres
À quoi sert API développeurs
Développeurs est la console de l’API Sanctions de LinkinLegal. Créez les clés API qu’utilisent vos systèmes, suivez chaque appel dans les graphiques d’utilisation et le journal des requêtes, et consultez votre formule API et vos factures, pour que vos propres outils d’entrée en relation et de KYC puissent vérifier des noms par rapport aux mêmes données de sanctions et de PPE que l’application.
Pour qui
Équipes techniques
Créer des clés, exécuter le démarrage rapide et retracer n’importe quel appel grâce à son ID de requête.
Responsables conformité et opérations
Suivre les volumes d’appels, l’activité des clés et la formule API au même endroit.
Les problèmes résolus
Le contrôle intégré à votre entrée en relation
Appelez les points de terminaison search et match depuis vos serveurs, pour que les nouveaux clients et contreparties soient contrôlés dans les systèmes que votre équipe utilise déjà.
Des clés que vous maîtrisez
Attribuez à chaque système sa propre clé avec une date d’expiration, voyez quand elle a servi pour la dernière fois, et révoquez-la dès qu’elle n’est plus nécessaire.
Chaque appel est enregistré
L’utilisation par jour, par point de terminaison et par clé, ainsi qu’un journal de chaque requête avec son statut, sa durée et son ID de requête.
Comment utiliser API développeurs
Chaque étape montre l’écran réel. Survolez un repère numéroté, ou la note correspondante, pour voir à quoi sert chaque commande.
Obtenir l’accès à l’API
Ouvrez Développeurs depuis le menu du compte. Tant que votre compte n’a pas de formule API, la console indique comment en obtenir une : notre équipe convient avec vous des API, du prix et d’une formule mensuelle ou annuelle, et l’accès commence dès le règlement de la première facture.
- Seul le titulaire d’un abonnement LinkinLegal récurrent peut détenir une formule API, et non les membres d’un espace de travail ni les détenteurs d’un Pass Jour ou d’un Pass Semaine.
- Chaque formule donne droit à des appels illimités à son API, dans la limite d’un usage raisonnable de 120 requêtes par minute.
- La formule API est distincte de votre abonnement LinkinLegal et se règle sur facture.
Sur cet écran
Se repérer dans la console
Avec une formule API, Développeurs s’ouvre sur la Vue d’ensemble : votre formule, les appels du mois, les clés actives et la limite de débit. Le menu de gauche mène aux Clés API, à l’Utilisation, à la Facturation et à la Documentation de l’API.
- Le Démarrage rapide est un appel curl prêt à l’emploi : ajoutez votre clé et envoyez-le.
- Le graphique Appels par jour couvre les 30 derniers jours, en UTC.
- Plus bas, Requêtes récentes liste vos derniers appels avec leur statut.
Sur cet écran
Créer et gérer des clés API
Dans Clés API, cliquez sur « Créer une clé », donnez à la clé un nom que vous reconnaîtrez, par exemple celui du système qui l’utilise, et choisissez sa date d’expiration. Chaque clé est listée avec ses premiers caractères, sa date d’expiration et sa dernière utilisation.
- L’expiration va de 1 heure à 1 an, ou « Aucune expiration ». Elle ne peut pas être modifiée par la suite.
- Jusqu’à 20 clés actives par compte ; noms de 60 caractères au maximum.
- « Révoquer » désactive une clé immédiatement. Les clés révoquées restent dans la liste, grisées.
Sur cet écran
Conseil : Utilisez une clé par système, par exemple votre service d’entrée en relation ou une tâche nocturne : en cas de fuite, vous ne perdez qu’une clé, et non toutes.
Enregistrez votre clé : elle n’est affichée qu’une fois
Après « Créer une clé », la boîte de dialogue affiche la clé complète. C’est la seule fois où vous la verrez : copiez-la dans votre gestionnaire de secrets avant de cliquer sur « Terminé ». Votre serveur l’envoie ensuite sous forme de jeton Bearer dans l’en-tête Authorization.
- URL de base : https://api.linkinlegal.com/v1. Par exemple, GET /sanctions/search ou POST /sanctions/match.
- POST /sanctions/match/batch contrôle jusqu’à 100 personnes ou entités en un seul appel.
- Clé perdue ? Révoquez-la et créez-en une nouvelle.
Sur cet écran
Suivre l’utilisation et chaque requête
L’onglet Utilisation représente les appels par jour sur 7, 30 ou 90 jours et les répartit par point de terminaison et par clé. En dessous, le journal des requêtes liste chaque appel. Sélectionnez une ligne pour voir son ID de requête et la requête envoyée.
- Filtrez le journal par statut (« Réussies » ou « Erreurs ») ou par clé.
- Les statuts verts ont abouti ; les rouges sont des erreurs, par exemple 402 sans formule ou 429 en cas de dépassement de la limite de débit.
- Le journal affiche 25 requêtes par page.
Sur cet écran
Conseil : Lorsque vous contactez le support au sujet d’un appel, indiquez son ID de requête. « Copier l’ID » le place dans votre presse-papiers.
Vérifier votre formule API et vos factures
L’onglet Facturation présente chaque API de votre formule avec son prix et sa date de renouvellement, votre prochaine facture, et chaque paiement avec un lien vers sa facture. Pour ajouter ou résilier une API, contactez notre équipe.
- Les factures sont envoyées par e-mail par Stripe ; l’accès commence dès le règlement de la première facture.
- Si un paiement échoue, la Vue d’ensemble vous prévient avant l’interruption de l’accès.
- Une formule résiliée reste active jusqu’à la fin de la période payée.
Sur cet écran
Étape 01 / 06
Tout ce que API développeurs sait faire
Les briques qui composent la visite guidée, et ce que chacune vous apporte.
Filtrage des sanctions et des PPE
Recherchez des fiches par nom, ou évaluez une personne ou une société avec match, jusqu’à 100 personnes ou entités par appel groupé.
Une clé par système
Nommez chaque clé d’après le système qui l’utilise, choisissez son expiration et révoquez-la lorsqu’elle n’est plus nécessaire.
L’utilisation en un coup d’œil
Les appels par jour sur 7, 30 ou 90 jours, par point de terminaison et par clé.
Un journal de chaque requête
Filtrez par statut ou par clé, et ouvrez n’importe quel appel pour voir son ID de requête et la requête.
Démarrage rapide
Un appel curl prêt à copier qui envoie votre clé sous forme de jeton Bearer.
Une limite d’usage raisonnable
120 requêtes par minute et par compte, partagées par toutes vos clés.
Règlement sur facture
Votre formule, sa date de renouvellement et chaque facture ou avoir.
Documentation complète de l’API
Démarrage rapide, authentification, erreurs et référence complète sur docs.linkinlegal.com.
Nos conseils pour bien l’utiliser
Gardez les clés sur votre serveur
Ne placez jamais une clé dans le code d’un navigateur ou d’une application mobile. Lisez-la depuis une variable d’environnement ou un gestionnaire de secrets.
Copiez la clé immédiatement
Elle n’est affichée en entier qu’une seule fois. Si vous la perdez, révoquez-la et créez-en une nouvelle.
Choisissez l’expiration avec soin
Il n’y a pas de valeur par défaut, et elle ne peut pas être modifiée par la suite. Pour faire une rotation, créez la nouvelle clé, déployez-la, puis révoquez l’ancienne.
Regroupez vos contrôles en masse
POST /sanctions/match/batch contrôle jusqu’à 100 personnes ou entités et compte comme une seule requête au regard de la limite de débit.
Consignez l’ID de requête
Chaque réponse comporte un en-tête X-Request-Id. Grâce à lui, le support peut retrouver votre appel précis.
Ne relancez pas les erreurs 401, 402 ou 403
Elles concernent la clé, la formule ou l’abonnement : le même appel échouera de nouveau. Ne relancez que les erreurs 429 et 503.
Les statuts que vous verrez
Les tâches qui s’exécutent en arrière-plan indiquent toujours où elles en sont. Voici ce que signifie chaque libellé.
- ActiveLa formule API est active et se renouvelle à la date indiquée.
- Facture envoyéeNotre équipe a configuré la formule. L’accès à l’API commence dès le règlement de la facture envoyée par e-mail.
- Échec du paiementLe dernier paiement de la formule API a échoué. L’accès sera interrompu si aucun paiement n’aboutit.
- RévoquéeLa clé ne fonctionne plus ; les appels qui l’utilisent sont refusés.
- ExpiréeLa clé a dépassé sa date d’expiration. Créez-en une nouvelle.
- 429Plus de 120 requêtes par minute. Attendez le délai indiqué par Retry-After, puis réessayez.
Vos questions, nos réponses
Vous ne trouvez pas ce qu’il vous faut ? Notre équipe répond à chaque message.
Contacter le supportLe titulaire d’un abonnement récurrent à l’application LinkinLegal. Les membres d’un espace de travail ne voient pas le lien Développeurs, et les détenteurs d’un Pass Jour ou d’un Pass Semaine ne peuvent pas obtenir d’accès à l’API.
Contactez notre équipe depuis la console. Nous convenons avec vous des API, du prix et d’une formule mensuelle ou annuelle, puis Stripe vous envoie la facture par e-mail. L’accès commence dès son règlement.
Une formule donne droit à des appels illimités à son API. Une limite d’usage raisonnable de 120 requêtes par minute s’applique à l’ensemble du compte et est partagée par toutes les clés.
Non. Seule une empreinte de la clé est conservée : la clé complète n’est donc affichée qu’une fois, à sa création. Révoquez la clé perdue et créez-en une nouvelle.
401 : la clé est absente, inconnue, révoquée ou expirée. 402 : le compte n’a pas de formule active pour cette API. 429 : vous avez dépassé 120 requêtes par minute. Attendez le délai indiqué par Retry-After, puis réessayez.
Choisissez Documentation de l’API dans le menu de la console, ou rendez-vous sur docs.linkinlegal.com pour le démarrage rapide, l’authentification, les limites de débit, les erreurs et la référence complète.
Pour aller plus loin
Fonctionnalités associées
- Où la trouver
- Menu du compte → Développeurs