Saltar al contingut principal
GET
curl

Visió general

Retorna una tasca de monitoratge AML continu iniciada des de Alternar el monitoratge AML per a usuaris o Alternar el monitoratge AML per a empreses: el seu estat, els comptadors per resultat i una entrada de results per cada usuari o empresa processat. Les seleccions de més de 20 perfils s’executen en segon pla, i la sol·licitud d’alternança retorna 202 amb una tasca PENDING. Consulta aquest endpoint cada dos segons aproximadament fins que status sigui COMPLETED o FAILED. results s’omple a mesura que es processen els perfils, en l’ordre de processament, i és complet quan la tasca està COMPLETED. Els resultats per registre es guarden per a les tasques iniciades a través de l’API; una tasca iniciada des de la Business Console només informa dels comptadors.

Estat de la tasca

Els valors de outcome per registre es documenten a les pàgines d’alternança.

Permisos

Qualsevol clau d’API activa de l’aplicació pot cridar aquest endpoint. Una tasca només és visible per a l’aplicació que l’ha creada; qualsevol altre job_id retorna 404.

Relacionats

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

job_id
string<uuid>
requerit

El job_id retornat per l'endpoint d'activació/desactivació.

Resposta

La tasca.

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

true quan la tasca activa el monitoratge, false quan el desactiva.

target_type
enum<string>

Quina família de perfils commuta la tasca.

Opcions disponibles:
user,
business
total
integer

Perfils que processa la tasca.

processed
integer

Perfils processats fins ara.

outcomes
object

Comptadors de resultats per registre. Cada perfil seleccionat s'assigna exactament a un comptador; no s'omet res silenciosament.

results
object[]

Una entrada per perfil processat, en ordre de processament. Creix mentre s'executa la tasca; es completa un cop l'estat és COMPLETED. Es registra per a les tasques iniciades mitjançant l'API; una tasca iniciada des de la Business Console només reporta comptadors.

error
string | null

Missatge d'error genèric quan l'estat és FAILED; la causa detallada es manté a la plataforma.

created_at
string<date-time>
completed_at
string<date-time> | null
Darrera modificació el 7 de novembre del 2026