Saltar al contingut principal
GET
curl

Visió general

Retorna una eliminació massiva de sessions iniciada amb Eliminar sessions en lot: el seu estat, quantes sessions ha processat i quantes han acabat en cada resultat. Quan més de 20 sessions KYC coincideixen amb una eliminació massiva, seleccionades amb session_numbers o amb delete_all, la sol·licitud retorna 202 amb una tasca PENDING i les sessions s’eliminen en segon pla. Consulta aquest endpoint cada pocs segons fins que status sigui COMPLETED o FAILED. Cada sessió que la tasca elimina s’elimina exactament igual que amb Eliminar sessió: s’eliminen la sessió, tots els intents de verificació que conté i tots els fitxers emmagatzemats, i les seves URL de contingut multimèdia deixen de resoldre’s. L’eliminació és permanent i irreversible. La tasca només informa de recomptes. Mai no enumera les sessions que ha eliminat.

Estat de la tasca

Una tasca delete_all només elimina les sessions creades abans de la sol·licitud. Les sessions iniciades mentre s’executa no s’eliminen.

Recomptes de resultats

deleted_child_verifications compta les verificacions que han creat les verificacions d’empreses eliminades i que s’han eliminat juntament amb elles. Sempre és 0 per a una tasca iniciada amb Eliminar sessions en lot, que només elimina sessions KYC.

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 amb el 202 de POST /v3/sessions/delete/.

Resposta

La tasca.

Una eliminació massiva de sessions en execució en segon pla: progrés i recomptes per resultat, mai quines sessions ha eliminat.

job_id
string<uuid>

Consulta periòdicament GET /v3/sessions/delete/{job_id}/ amb aquest id.

status
enum<string>

PENDING: acceptat, encara no iniciat. PROCESSING: suprimint; processed i outcomes s'estan actualitzant. COMPLETED: s'ha donat compte de totes les sessions seleccionades. FAILED: la feina s'ha aturat abans d'hora; consulta error.

Opcions disponibles:
PENDING,
PROCESSING,
COMPLETED,
FAILED
total
integer

Sessions seleccionades quan es va sol·licitar la supressió.

processed
integer

Sessions que la tasca ha completat fins ara.

outcomes
object

Quantes sessions han acabat en cada resultat. Totes les claus estan sempre presents.

deleted_child_verifications
integer

Verificacions creades per les verificacions d'empreses eliminades, eliminades amb elles. Sempre és 0 per a una tasca iniciada per POST /v3/sessions/delete/, que només elimina sessions de KYC.

error
string | null

null tret que status sigui FAILED; en aquest cas, el motiu pel qual s'ha aturat l'eliminació. Les sessions a les quals la tasca no ha arribat continuen existint: repeteix la sol·licitud per eliminar-les.

created_at
string<date-time>

Quan es va sol·licitar l'eliminació.

completed_at
string<date-time> | null

Quan va finalitzar la tasca; null mentre s'està executant.

Darrera modificació el 7 de novembre del 2026