Passer au contenu principal
POST
curl

Vue d’ensemble

Active ou désactive la surveillance AML continue pour les entreprises sélectionnées, exactement comme l’action Surveillance AML continue du Business Console. La Console et cet endpoint exécutent la même opération sous-jacente : les règles, la facturation et les résultats sont donc identiques. Envoyez d’abord estimate_only: true pour connaître le nombre d’entreprises sélectionnées, le nombre d’entreprises qui nécessitent un nouveau filtrage AML, le coût unique du filtrage et le coût annuel de la surveillance. Une exécution à blanc n’écrit rien. L’estimation utilise les mêmes noms de champs que l’endpoint des utilisateurs : users_total correspond donc au nombre d’entreprises sélectionnées.

Traitement d’une sélection

  • Un seul filtrage surveillé par entreprise. Une entreprise qui a été vérifiée plusieurs fois est surveillée et facturée une seule fois. La désactivation arrête la surveillance sur l’ensemble des filtrages de cette entreprise.
  • Les entreprises sans filtrage AML sont d’abord filtrées. Didit crée pour elles une nouvelle vérification AML (visible dans l’onglet Vérifications de l’entreprise), facturée comme un filtrage AML classique, et active la surveillance sur ce filtrage. Le filtrage utilise la raison sociale (ou le nom d’affichage) et le pays de l’entreprise. Une entreprise sans aucun nom est signalée avec skipped_no_identity_data au lieu d’être ignorée silencieusement.
  • Les applications sandbox ne créent jamais de filtrage (skipped_sandbox).
  • Le solde est vérifié au préalable. L’activation est refusée avec 403 lorsque votre solde ne couvre pas l’estimation. La réponse contient alors l’estimation, afin que vous sachiez combien recharger.
  • Renouvellement annuel. Une entreprise nouvellement surveillée est facturée au tarif annuel de la surveillance à sa prochaine date de renouvellement, celle que la Console affiche dans la colonne Surveillance continue. La désactivation arrête le renouvellement ; elle ne rembourse pas une période déjà facturée.

Sélection et taille du lot

Sélectionnez des entreprises avec vendor_data_list, didit_internal_id_list, ou les deux ; les deux listes sont combinées par un opérateur OR. Une requête accepte au maximum 1000 identifiants au total pour les deux listes. Les identifiants qui ne correspondent à aucune entreprise de votre application sont renvoyés sous unmatched, tels qu’envoyés, et ne font jamais échouer la requête : une sélection sans correspondance se termine comme une tâche vide (total: 0) avec tous les identifiants listés, selon la même convention que les endpoints de suppression par lot.

Traitement synchrone ou en arrière-plan

Les sélections de 20 entreprises ou moins sont traitées de manière synchrone, et l’appel renvoie 200 avec la tâche terminée. Les sélections plus importantes renvoient 202 avec une tâche PENDING ; interrogez Obtenir la tâche de surveillance AML jusqu’à ce que status vaille COMPLETED ou FAILED. Dans les deux cas, la tâche contient une entrée results par entreprise, avec son outcome.

Webhooks

L’activation ou la désactivation de la surveillance n’émet aucun webhook propre. Une fois la surveillance active, les refiltrages continuent de déclencher les événements habituels status.updated et data.updated décrits dans Surveillance AML continue.

Autorisations

Toute clé API active de l’application peut appeler cet endpoint. Les clés API Didit sont limitées à l’application, et non au rôle : les rôles et autorisations de la Console déterminent ce qu’une personne peut faire dans la Console, et ne sont pas évalués pour le trafic de la Management API.

Voir aussi

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Corps

application/json

Sélectionnez des entreprises avec vendor_data_list, didit_internal_id_list, ou les deux (les deux listes sont combinées avec un opérateur OU). Au maximum 1000 identifiants par requête sur l'ensemble des deux listes.

is_enabled
boolean
requis

true pour activer la surveillance, false pour la désactiver.

estimate_only
boolean
défaut:false

Si true, renvoie l'estimation des coûts et n'effectue aucune écriture : aucun filtrage, aucune facturation, aucune tâche.

vendor_data_list
string[]

Vos propres identifiants des entreprises à basculer, mis en correspondance exacte avec ceux transmis.

didit_internal_id_list
string<uuid>[]

Identifiants internes Didit des entreprises à basculer - le didit_internal_id renvoyé par les endpoints de création, de récupération et de liste.

Réponse

L'estimation (lorsque estimate_only est true) ou la tâche terminée pour une sélection traitée en ligne.

Aperçu du coût. Renvoyé directement lorsque estimate_only est vrai (rien n'est écrit).

users_total
integer
requis

Profils correspondant à la sélection.

already_enabled
integer
requis

Profils déjà surveillés (aucune action lors de l'activation ; ce sont ceux que la désactivation désactive).

with_existing_aml
integer
requis

Profils dont le filtrage AML existant passera en mode surveillé (aucun nouveau filtrage).

needing_screening
integer
requis

Profils sans aucun filtrage AML qui seront d'abord filtrés (facturés comme un filtrage AML standard).

skipped_no_identity_data
integer
requis

Profils ne pouvant pas faire l'objet d'un filtrage en raison de données d'identité manquantes.

skipped_blocked
integer
requis

Utilisateurs bloqués qui seront ignorés (toujours 0 pour les entreprises).

estimated_screening_cost_usd
number
requis

Coût ponctuel des nouveaux filtrages.

Exemple:

0.2

estimated_annual_monitoring_cost_usd
number
requis

Coût de surveillance annuel des profils qui deviendront surveillés.

Exemple:

0.07

balance_sufficient
boolean
requis

Indique si le solde de l'organisation couvre le filtrage ainsi que la première année de surveillance.

unmatched
string[]
requis

Identifiants de la requête ne correspondant à aucun profil dans cette application, exactement tels qu'envoyés.

Dernière modification le 7 novembre 2026