Vai al contenuto principale
POST
curl
Risolvi un caso. Se il suo blueprint è abbinato a un blueprint con un passaggio di revisione a quattro occhi, questa operazione prepara la risoluzione invece di chiudere il caso. Controlla il campo pending_resolution della risposta per distinguere i due esiti.

Indicare il checker

In un blueprint con un passaggio di verifica a quattro occhi, invia checker con l’uuid dell’utente del membro che deve approvare la risoluzione. Solo quel membro può poi approvarla o rifiutarla; chiunque altro, compresa una chiave API, riceve 403. Il campo checker del caso indica questo membro finché la risoluzione non viene approvata, rifiutata o restituita per una nuova revisione perché le prove sono cambiate. Senza checker, la risoluzione resta in attesa nella coda del blueprint di verifica. Il membro deve avere accesso al caso per questa applicazione e non può essere il responsabile che invia la risoluzione. In un blueprint senza un passaggio checker, checker restituisce 400.

Le risoluzioni a quattro occhi richiedono un membro della console

Invia una risoluzione che passa per la revisione a quattro occhi come membro della console, non con una chiave API. Una risoluzione inviata con una chiave API non ha un autore registrato, quindi le operazioni di approvazione e rifiuto della risoluzione restituiscono 403 a tutti i chiamanti, incluso il checker indicato.

Accesso

Gli endpoint dei casi richiedono una chiave API con accesso completo. Una chiave con accesso limitato riceve 403.

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

organization_id
string<uuid>
obbligatorio

UUID dell'organizzazione.

application_id
string<uuid>
obbligatorio

UUID dell'applicazione.

case_uuid
string<uuid>
obbligatorio

UUID del caso.

Esempio:

"c1a5e000-0000-4000-8000-000000000001"

Corpo

application/json
resolution
enum<string>
obbligatorio
Opzioni disponibili:
FALSE_POSITIVE,
VALID_THREAT,
INCONCLUSIVE,
REQUIREMENTS_NOT_MET,
REQUIREMENTS_SATISFIED
note
string | null

Obbligatorio quando il blueprint imposta require_resolution_note.

checker
string<uuid> | null

Solo modelli a quattro occhi. L'uuid utente del membro che deve approvare questa risoluzione (lo stesso id di assigned_to.uuid su un caso, o members[].user_id su un team di revisione). Il membro deve avere accesso ai casi per questa applicazione e non può essere il responsabile che invia la risoluzione. Omettilo o invia null per lasciare la risoluzione alla coda del controllore.

Risposta

Risolto o in attesa di approvazione a 4 occhi.

uuid
string<uuid>
case_number
string | null
title
string
status
enum<string>
Opzioni disponibili:
OPEN,
AWAITING_USER,
RESOLVED
resolution
enum<string> | null
Opzioni disponibili:
FALSE_POSITIVE,
VALID_THREAT,
INCONCLUSIVE,
REQUIREMENTS_NOT_MET,
REQUIREMENTS_SATISFIED
resolution_notes
string | null
priority
enum<string>
Opzioni disponibili:
LOW,
MEDIUM,
HIGH
source
enum<string>
Opzioni disponibili:
MANUAL,
AML_SCREENING,
TRANSACTION_RULE,
WORKFLOW_BUILDER
tags
string[]
subject
object | null

L'unico utente o azienda a cui è associato il caso.

assigned_to
object | null
assigned_at
string<date-time> | null
team
object | null

Il team di revisione assegnatario del caso, oppure null se non è assegnato ad alcun team. L'instradamento lo imposta quando una regola di instradamento assegna il caso a uno dei suoi team. Modificalo o cancellalo con PATCH .../cases/{case_uuid}/ (team).

due_at
string<date-time> | null
resolved_at
string<date-time> | null
resolved_by_email
string | null
pending_resolution
object | null

Impostato solo mentre una risoluzione a 4 occhi è predisposta sul blueprint checker, in attesa di approvazione o rifiuto dell'approvazione.

checker
object | null

Il membro designato per approvare o rifiutare la risoluzione in sospeso. Impostato solo mentre una risoluzione a quattro occhi attende un verificatore designato. Null quando non c'è nulla in sospeso, mentre la risoluzione in sospeso attende nella coda dei verificatori e una volta che la risoluzione è approvata, rifiutata o restituita per una nuova revisione a seguito della modifica delle prove.

metadata
object
blueprint
object
notes
object[]

Le 50 note più recenti.

events
object[]

I 100 eventi più recenti.

notes_count
integer
checklist_items
object[]
created_at
string<date-time>
updated_at
string<date-time>
Ultima modifica il 7 novembre 2026