Primers passos
Integració / SDK
Verificació d'usuaris
Verificació d'empreses
Monitoratge de transaccions
Registre de canviscurl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.networks.retrieve(
"n3a5e000-0000-4000-8000-000000000001",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
const result = await didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.networks().retrieve("n3a5e000-0000-4000-8000-000000000001");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
var result = await client.Networks.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"network_id": "N-0042",
"name": null,
"status": "in_review",
"risk": {
"score": 82,
"band": "high",
"bar": 0.82
},
"pattern_types": [
"exact_same_device",
"same_email"
],
"signal_types": [
"device",
"email"
],
"member_counts": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signal_coverage": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
},
"first_activity_at": "2026-10-01T09:12:44Z",
"last_activity_at": "2026-10-12T16:03:10Z",
"stats": {
"members": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signals": {
"total": 2,
"by_type": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
}
}
},
"fraud_tags": [],
"risk_signals": {
"residential_proxy_reuse": {
"detected": false,
"signal_count": 0,
"max_subject_count": 0
},
"email_intelligence": {
"enriched_signal_count": 1,
"high_risk_count": 0,
"social_profile_count": 0
},
"phone_intelligence": {
"enriched_signal_count": 0,
"high_risk_count": 0
}
},
"reviewed_at": "2026-10-12T16:30:00Z",
"reviewed_by": "reviewer@example.com",
"review_reason": "Shared device across three new accounts.",
"notes_count": 0,
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"tags": [
{
"uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "SUSPICIOUS",
"color": "#6366F1",
"source": "custom",
"added_by": null,
"added_at": "2026-10-13T08:15:00Z"
}
],
"outcomes": {
"approved": 1,
"declined": 1,
"in_review": 0,
"total": 3
},
"patterns": [
{
"type": "background",
"score": 0.8125,
"members": 3,
"reason": null,
"computed_at": "2026-10-13T08:00:00Z"
}
]
}API per obtenir xarxa de frau
Obtén una xarxa de frau a Didit amb estadístiques, etiquetes de frau, senyals de risc, resultats dels membres i puntuació de patró de fons selfie.
curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.networks.retrieve(
"n3a5e000-0000-4000-8000-000000000001",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
const result = await didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.networks().retrieve("n3a5e000-0000-4000-8000-000000000001");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
var result = await client.Networks.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"network_id": "N-0042",
"name": null,
"status": "in_review",
"risk": {
"score": 82,
"band": "high",
"bar": 0.82
},
"pattern_types": [
"exact_same_device",
"same_email"
],
"signal_types": [
"device",
"email"
],
"member_counts": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signal_coverage": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
},
"first_activity_at": "2026-10-01T09:12:44Z",
"last_activity_at": "2026-10-12T16:03:10Z",
"stats": {
"members": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signals": {
"total": 2,
"by_type": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
}
}
},
"fraud_tags": [],
"risk_signals": {
"residential_proxy_reuse": {
"detected": false,
"signal_count": 0,
"max_subject_count": 0
},
"email_intelligence": {
"enriched_signal_count": 1,
"high_risk_count": 0,
"social_profile_count": 0
},
"phone_intelligence": {
"enriched_signal_count": 0,
"high_risk_count": 0
}
},
"reviewed_at": "2026-10-12T16:30:00Z",
"reviewed_by": "reviewer@example.com",
"review_reason": "Shared device across three new accounts.",
"notes_count": 0,
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"tags": [
{
"uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "SUSPICIOUS",
"color": "#6366F1",
"source": "custom",
"added_by": null,
"added_at": "2026-10-13T08:15:00Z"
}
],
"outcomes": {
"approved": 1,
"declined": 1,
"in_review": 0,
"total": 3
},
"patterns": [
{
"type": "background",
"score": 0.8125,
"members": 3,
"reason": null,
"computed_at": "2026-10-13T08:00:00Z"
}
]
}Etiquetes
tags enumera les etiquetes de la teva aplicació a la xarxa, de la més antiga a la més recent.
Cada aplicació només veu i modifica les seves pròpies etiquetes.
added_by és el correu electrònic del membre de la consola que ha afegit l’etiqueta, o null quan l’ha afegit una clau d’API.
Fes servir Afegeix una etiqueta a la xarxa i Elimina una etiqueta de la xarxa per canviar-les.
fraud_tags no canvia: enumera les etiquetes que porten els membres de la xarxa.
Resultats dels membres
outcomes compta les persones i empreses de la xarxa que pots veure, cadascuna només una vegada.
| Clau | Què compta |
|---|---|
approved | Membres la verificació decidida més recent dels quals ha estat aprovada |
declined | Membres la verificació decidida més recent dels quals ha estat rebutjada |
in_review | Membres la verificació decidida més recent dels quals està en revisió |
total | Membres amb almenys una verificació, decidida o no |
approved.
Un membre que té totes les verificacions sense decidir (no iniciades, en curs, caducades o abandonades) només compta en el total (total).
Les parts de les transaccions no passen per cap verificació i no es comptabilitzen.
Patró de fons de la selfie
patterns conté, de moment, un element, amb type establert a background.
El seu score, d’0 a 1, és la similitud mitjana de totes les parelles de fons de selfies dels membres, amb la persona emmascarada.
Una puntuació propera a 1 suggereix que les selfies es van fer al mateix lloc.
Les parets llises d’un color semblant també poden obtenir una puntuació alta, així que considera la puntuació com a evidència per revisar, no com a prova.
La puntuació llegeix la selfie més recent de cada persona, com a màxim les 50 més recents, i deixa fora les sessions de verificació d’edat.
Cobreix tota la xarxa, no només els membres de les teves aplicacions.
reason | score | members | Què fer |
|---|---|---|---|
null | de 0 a 1 | Selfies comparades | Fes servir la puntuació. computed_at indica quan es va calcular. |
computing | null | null | S’està calculant la puntuació dels membres actuals. Torna a llegir la xarxa més tard. |
not_enough_selfies | null | 0 o 1 | Hi ha menys de dos membres amb una selfie utilitzable. |
members pot ser inferior al nombre de persones de la xarxa.
La puntuació sempre descriu les selfies actuals dels membres.
Quan canvien, per exemple quan un membre s’uneix o marxa, el detall mostra computing fins que la nova puntuació estigui a punt, o not_enough_selfies quan en queden menys de dos.
Disponibilitat entre organitzacions
El detall inclou els mateixossharing_mode, cross_org_available i cross_org_unavailable_reason que Llista de xarxes.
Els senyals entre organitzacions necessiten tant el pla Enterprise com el mode de compartició global.
Relacionats
- Llista de xarxes
- Afegeix una etiqueta a la xarxa
- Elimina una etiqueta de la xarxa
- Membres de la xarxa
- Graf de la xarxa
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"
Resposta
Detall de la xarxa.
El detall de la xarxa, a més del mode d'ús compartit de l'organització, si se li apliquen senyals interorganitzatius, les etiquetes de la teva aplicació a la xarxa, els resultats dels membres i les puntuacions de patrons.
ID seqüencial per organització llegible per a humans, p. ex. N-0001.
Estat del cicle de vida de la xarxa. Distint de l'outcome_status per sol·licitant dins d'una xarxa (approved/in_review/declined/not_completed).
active, in_review, resolved, dismissed Show child attributes
Show child attributes
Els patrons d'agrupament detectats en aquesta xarxa.
exact_same_device, similar_device, same_ip_address, same_address, similar_selfie_backgrounds, similar_poa_documents, same_document_number, same_phone_number, same_email Els diferents tipus de senyals presents en aquesta xarxa.
ip_address, device, face, document_number, phone, email, address Recomptes de membres per categoria (p. ex. total, per outcome_status).
Desglossament dels membres per outcome_status.
Cobertura dels membres d'aquesta xarxa per signal_type.
Estadístiques agregades de la xarxa (p. ex., totals de membres).
Etiquetes de patrons de frau detectades a la xarxa.
Resums dels senyals de risc: residential_proxy_reuse, email_intelligence, phone_intelligence.
Nombre de notes privades d'analista en aquesta investigació.
x >= 0El mode de compartició entre organitzacions de l'organització. Només global compara xarxes entre organitzacions; private i off les mantenen a l'historial propi de l'organització.
off, private, global "global"
Indica si els senyals entre organitzacions s'apliquen a aquesta organització. Necessiten tant el pla Enterprise com el mode de compartició global.
true
Per què no s'apliquen els senyals interorganitzacionals, comprovats en aquest ordre. plan: el pla de l'organització no inclou la xarxa de frau interorganitzacional (necessita el pla Enterprise), independentment del mode de compartició. sharing_mode: el pla la inclou, però el mode de compartició és private o off. Null quan cross_org_available és true.
plan, sharing_mode null
Les etiquetes de la teva aplicació a la xarxa, les més antigues primer. Cada aplicació només veu les seves pròpies etiquetes. fraud_tags és independent i no canvia: les etiquetes que porten els membres de la xarxa.
Show child attributes
Show child attributes
Estat en què es troben les persones i empreses de la xarxa. Cada membre que pots veure compta un cop, segons l'estat de la seva verificació més recent que hagi arribat a una decisió. Les parts de la transacció no es comptabilitzen.
Show child attributes
Show child attributes
Puntuacions de patrons a tota la xarxa. Actualment un element, background.
Show child attributes
Show child attributes