Vai al contenuto principale
GET
curl

Panoramica

Restituisce un job di monitoraggio AML continuo avviato da Attiva il monitoraggio AML per gli utenti o da Attiva il monitoraggio AML per le aziende: il suo stato, i contatori per esito e una voce results per ogni utente o azienda elaborata. Le selezioni di oltre 20 profili vengono eseguite in background e la chiamata di attivazione restituisce 202 con un job PENDING. Interroga questo endpoint ogni due secondi circa finché status non diventa COMPLETED o FAILED. results si riempie man mano che i profili vengono elaborati, nell’ordine di elaborazione, ed è completo quando il job è COMPLETED. I risultati per singolo record vengono registrati per i job avviati tramite API; un job avviato dalla Business Console riporta solo i contatori.

Stato del job

I valori outcome per singolo record sono documentati nelle pagine di attivazione.

Autorizzazioni

Qualsiasi chiave API attiva dell’applicazione può chiamare questo endpoint. Un job è visibile solo all’applicazione che lo ha creato; qualsiasi altro job_id restituisce 404.

Correlati

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

job_id
string<uuid>
obbligatorio

Il job_id restituito dall'endpoint di attivazione/disattivazione.

Risposta

Il job.

job_id
string<uuid>
status
enum<string>
Opzioni disponibili:
PENDING,
PROCESSING,
COMPLETED,
FAILED
is_enabled
boolean

true quando il job abilita il monitoraggio, false quando lo disabilita.

target_type
enum<string>

Quale famiglia di profili viene attivata o disattivata dal job.

Opzioni disponibili:
user,
business
total
integer

Profili elaborati dal job.

processed
integer

Profili elaborati finora.

outcomes
object

Contatori di esito per singolo record. Ogni profilo selezionato corrisponde esattamente a un contatore; nulla viene ignorato silenziosamente.

results
object[]

Una voce per ogni profilo elaborato, nell'ordine di elaborazione. Aumenta durante l'esecuzione del job; completa una volta che lo stato è COMPLETED. Registrata per i job avviati tramite API; un job avviato dalla Business Console riporta solo i conteggi.

error
string | null

Messaggio di errore generico quando lo stato è FAILED; la causa dettagliata viene conservata lato piattaforma.

created_at
string<date-time>
completed_at
string<date-time> | null
Ultima modifica il 7 novembre 2026