Primers passos
Integració / SDK
Verificació d'usuaris
Verificació d'empreses
Monitoratge de transaccions
Registre de canvisAPI de cronologia de xarxes de frau
Obtén l’historial de la xarxa de frau a Didit; amb contract=2, una cronologia paginada d’intents, transaccions, sessions, regles i casos.
contract, la resposta és l’historial propi de la xarxa, del més antic al més recent i sense paginació: quan es va detectar per primera vegada, quan es va observar per última vegada cada senyal i el seu darrer canvi d’estat amb el motiu.
Aquesta forma no ha canviat, i limit, cursor i event_type s’ignoren.
Cronologia tipificada
Passacontract=2 per llegir la cronologia tipificada.
Afegeix el que van fer els comptes membres i el que va fer el teu equip sobre la xarxa, del més recent al més antic, una pàgina cada vegada.
contract només accepta 2; qualsevol altre valor retorna 400.
| Paràmetre | Significat |
|---|---|
limit | Esdeveniments per pàgina, de 1 a 500. Per defecte, 100. |
cursor | El next_cursor de la pàgina anterior. Un cursor no vàlid o buit retorna 400. |
event_type | Els tipus d’esdeveniment que cal conservar, repetits o separats per comes, com a màxim 20 valors. Per defecte, tots els tipus. |
{"results": [...], "next_cursor": "..."}.
Llegeix la pàgina següent amb cursor igual a next_cursor, fins que next_cursor sigui null.
Tipus d’esdeveniment
event_type | Què registra | Bloc de detall |
|---|---|---|
network_detected | La xarxa va ser detectada | Cap |
signal_observed | La darrera observació d’un senyal | Cap |
network_active, network_in_review, network_resolved, network_dismissed | El darrer canvi d’estat de la xarxa, amb el seu motiu a metadata | Cap |
verification_attempt | Una sessió de verificació d’un membre (una persona o una empresa), numerada (attempt de attempt_count), amb els motius de rebuig quan ha estat rebutjada | verification_attempt |
transaction | Una transacció en què va participar un membre, datada segons la seva data de transacció | transaction |
login | Un inici de sessió o un inici de sessió fallit que has enviat per a un membre mitjançant l’API d’esdeveniments | login |
rule_hit | Una regla activa que coincideix amb una transacció o un esdeveniment d’un membre | rule_hit |
case_linked | Un cas obert per a la xarxa a la teva organització | case_linked |
note_added | Una nota deixada sobre la xarxa, sense el seu text | note_added |
note_added només es retornen als membres de la consola, mai a una clau d’API.
Una transacció entre dos membres apareix una vegada per a cadascun, cadascuna amb el seu propi account.
Una coincidència de regla sobre aquesta transacció apareix una sola vegada.
Els esdeveniments d’inici de sessió només existeixen per als inicis de sessió que enviïs com a esdeveniments: auth.login, security.login_succeeded i les seves formes fallides.
Comptes i registres
Cada esdeveniment de membre inclouaccount, el membre al qual pertany, i source_ref, la sessió, la sessió empresarial, la transacció, l’esdeveniment de monitoratge o el cas del qual s’ha llegit.
ownership és owned quan el registre pertany a l’aplicació que has cridat, i organization quan pertany a una altra aplicació de la teva organització.
route indica el tipus de registre, el UUID i l’aplicació; source_ref no té route per a un esdeveniment de monitoratge ni per a un cas.
Els esdeveniments propis de la xarxa no tenen ni account ni source_ref.
Relacionat
Autoritzacions
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
UUID de l'organització.
UUID de l'aplicació.
UUID de la xarxa.
"n3a5e000-0000-4000-8000-000000000001"
Paràmetres de consulta
2 retorna la cronologia tipada. Omet-lo per a la cronologia per defecte. Qualsevol altre valor retorna 400.
2 Només per a la cronologia tipada. Esdeveniments per pàgina, d'1 a 500. El valor per defecte és 100.
1 <= x <= 500Només per a la cronologia tipada. El next_cursor de la pàgina anterior. Un cursor buit o no vàlid retorna 400.
Només per a la cronologia tipada. Tipus d'esdeveniments que cal mantenir, repetits o separats per comes, com a màxim 20 valors. Per defecte inclou tots els tipus.
20network_detected, signal_observed, network_active, network_in_review, network_resolved, network_dismissed, verification_attempt, transaction, login, rule_hit, case_linked, note_added Resposta
Sense contract: {results}, els més antics primer, sense paginar. Amb contract=2: {results, next_cursor}, els més recents primer.
- Default timeline (no contract)
- Typed timeline page (contract=2)
Sense contract: els esdeveniments propis de la xarxa, primer els més antics, sense paginació.
Show child attributes
Show child attributes