Saltar al contingut principal
POST
curl

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.

Capçaleres

Content-Type
string

Estableix-ho a application/json quan enviïs un cos JSON.

Exemple:

"application/json"

Paràmetres de ruta

session_id
string<uuid>
requerit

UUID de la sessió de Verificació d'usuaris (KYC). Ha de pertànyer a la mateixa aplicació que la clau d'API: els UUID d'altres aplicacions, les sessions suprimides i els ID de sessió de Verificació d'empreses (KYB) retornen tots un 404.

Exemple:

"8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d"

Cos

application/json
new_status
enum<string> | null

Etiqueta d'estat opcional per registrar a l'entrada. Accepta qualsevol valor d'estat de sessió, sensible a majúscules i minúscules ("approved" es rebutja amb 400). Registrar un estat aquí no canvia l'estat real de la sessió; fes servir l'endpoint d'actualització d'estat per a això.

Opcions disponibles:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
Exemple:

"In Review"

comment
string | null

Nota opcional en text lliure (sense límit de longitud establert). Es desa literalment; les mencions @email no es processen en aquest endpoint.

Exemple:

"Flagging for manual document re-check."

Resposta

Entrada registrada al registre d'auditoria de la sessió. La sessió en si no canvia: el seu status manté el valor anterior i no s'envia cap webhook. La nova entrada també apareix a la part superior de GET …/reviews/ (amb actor_display: "Unknown").

user
string

Nom visible de l'autor de l'entrada. Sempre "Unknown" per a entrades creades mitjançant aquest endpoint, ja que no registra cap atribució d'actor.

Exemple:

"Unknown"

new_status
enum<string> | null

L'etiqueta d'estat registrada a l'entrada, o null si no se n'ha enviat cap. L'estat real de la sessió no es veu afectat.

Opcions disponibles:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
Exemple:

"In Review"

comment
string | null

La nota registrada a l'entrada, o null si no se'n va enviar cap.

Exemple:

"Flagging for manual document re-check."

created_at
string<date-time>

Quan es va escriure l'entrada, ISO 8601 UTC.

Exemple:

"2026-06-12T00:18:44.466537Z"

Darrera modificació el 7 de novembre del 2026