Passer au contenu principal
GET
curl

Vue d’ensemble

Renvoie une tâche de surveillance AML continue lancée depuis Activer ou désactiver la surveillance AML des utilisateurs ou Activer ou désactiver la surveillance AML des entreprises : son statut, les compteurs par résultat et une entrée results pour chaque utilisateur ou entreprise traité. Les sélections de plus de 20 profils sont traitées en arrière-plan, et l’appel d’activation ou de désactivation renvoie 202 avec une tâche PENDING. Interrogez cet endpoint toutes les deux secondes environ, jusqu’à ce que status soit COMPLETED ou FAILED. results se remplit au fur et à mesure du traitement des profils, dans l’ordre de traitement, et est complet une fois que la tâche est COMPLETED. Les résultats par enregistrement sont conservés pour les tâches lancées via l’API ; une tâche lancée depuis la Business Console ne fournit que des compteurs.

Statut de la tâche

Les valeurs de outcome par enregistrement sont documentées sur les pages d’activation ou de désactivation.

Autorisations

Toute clé API active de l’application peut appeler cet endpoint. Une tâche n’est visible que par l’application qui l’a créée ; tout autre job_id renvoie 404.

Pages associées

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.

Paramètres de chemin

job_id
string<uuid>
requis

Le job_id renvoyé par l'endpoint de basculement.

Réponse

La tâche.

job_id
string<uuid>
status
enum<string>
Options disponibles:
PENDING,
PROCESSING,
COMPLETED,
FAILED
is_enabled
boolean

true lorsque le traitement active la surveillance, false lorsqu'il la désactive.

target_type
enum<string>

Quelle famille de profils la tâche active ou désactive.

Options disponibles:
user,
business
total
integer

Profils traités par la tâche.

processed
integer

Profils traités jusqu'à présent.

outcomes
object

Compteurs de résultats par enregistrement. Chaque profil sélectionné est associé à exactement un compteur ; rien n'est ignoré silencieusement.

results
object[]

Une entrée par profil traité, dans l'ordre de traitement. La liste s'allonge pendant l'exécution de la tâche ; complète une fois que le statut est COMPLETED. Enregistré pour les tâches démarrées via l'API ; une tâche démarrée depuis la Business Console ne renvoie que des compteurs.

error
string | null

Message d'échec générique lorsque le statut est FAILED ; la cause détaillée est conservée côté plateforme.

created_at
string<date-time>
completed_at
string<date-time> | null
Dernière modification le 7 novembre 2026