Primeiros passos
Integração / SDKs
Verificação de usuários
Verificação de empresas
Monitoramento de transações
Registro de alteraçõescurl -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 para obter rede de fraude
Veja uma rede de fraude no Didit: estatísticas, tags, sinais de risco, resultados de membros, padrão de fundo de selfie e acesso entre organizações.
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"
}
]
}Tags
tags lista as tags da sua aplicação na rede, da mais antiga para a mais recente.
Cada aplicação vê e altera apenas as próprias tags.
added_by é o e-mail do membro do painel que adicionou a tag, ou null quando ela foi adicionada por uma chave de API.
Use Adicionar tag de rede e Remover tag de rede para alterá-las.
fraud_tags não muda: lista as tags que os membros da rede têm.
Resultados dos membros
outcomes conta as pessoas e empresas da rede que você tem permissão para ver, cada uma contada uma única vez.
| Chave | O que conta |
|---|---|
approved | Membros cuja verificação decidida mais recente foi aprovada |
declined | Membros cuja verificação decidida mais recente foi recusada |
in_review | Membros cuja verificação decidida mais recente está em revisão |
total | Membros com pelo menos uma verificação, decidida ou não |
approved.
Um membro cujas verificações estão todas sem decisão (não iniciadas, em andamento, expiradas ou abandonadas) conta apenas em total.
As partes envolvidas em transações não passam por nenhuma verificação e não são contadas.
Padrão de fundo das selfies
patterns contém hoje um único item, com type definido como background.
O score dele, de 0 a 1, é a similaridade média entre todos os pares de fundos das selfies dos membros, com a pessoa ocultada.
Uma pontuação próxima de 1 sugere que as selfies foram tiradas no mesmo lugar.
Paredes lisas de cor parecida também podem ter pontuação alta, então trate a pontuação como evidência para revisão, não como prova.
A pontuação considera a selfie mais recente de cada pessoa, no máximo as 50 mais recentes, e exclui as sessões de verificação de idade.
Ela abrange a rede inteira, não apenas os membros das suas aplicações.
reason | score | members | O que fazer |
|---|---|---|---|
null | 0 a 1 | Selfies comparadas | Use a pontuação. computed_at informa quando ela foi calculada. |
computing | null | null | A pontuação dos membros atuais está sendo calculada. Consulte a rede novamente mais tarde. |
not_enough_selfies | null | 0 ou 1 | Menos de dois membros têm uma selfie utilizável. |
members pode ser menor que o número de pessoas na rede.
A pontuação sempre descreve as selfies atuais dos membros.
Quando elas mudam, por exemplo quando um membro entra ou sai, o detalhe informa computing até que a nova pontuação esteja pronta, ou not_enough_selfies quando restam menos de dois.
Disponibilidade entre organizações
Os detalhes trazem os mesmossharing_mode, cross_org_available e cross_org_unavailable_reason que listar redes.
Os sinais entre organizações exigem o plano Enterprise e o modo de compartilhamento global.
Conteúdos relacionados
Autorizações
Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.
Parâmetros de caminho
UUID da organização.
UUID da aplicação.
UUID da rede.
"n3a5e000-0000-4000-8000-000000000001"
Resposta
Detalhes da rede.
Os detalhes da rede, além do modo de compartilhamento da organização, se os sinais entre organizações se aplicam a ela, as tags da sua aplicação na rede, os resultados dos membros e as pontuações de padrões.
ID sequencial legível por organização, por exemplo N-0001.
Status do ciclo de vida da rede. Diferente do outcome_status por candidato dentro de uma rede (approved/in_review/declined/not_completed).
active, in_review, resolved, dismissed Show child attributes
Show child attributes
Os padrões de agrupamento detectados nesta rede.
exact_same_device, similar_device, same_ip_address, same_address, similar_selfie_backgrounds, similar_poa_documents, same_document_number, same_phone_number, same_email Os tipos de sinal distintos presentes nesta rede.
ip_address, device, face, document_number, phone, email, address Contagens de membros por categoria (por exemplo, total, por outcome_status).
Distribuição dos membros por outcome_status.
Cobertura por signal_type dos membros desta rede.
Estatísticas agregadas da rede (por exemplo, totais de membros).
Tags de padrões de fraude identificadas na rede.
Resumos dos sinais de risco: residential_proxy_reuse, email_intelligence, phone_intelligence.
Número de notas privadas de analistas nesta investigação.
x >= 0O modo de compartilhamento entre organizações da organização. Somente global compara redes entre organizações; private e off as restringem ao histórico da própria organização.
off, private, global "global"
Indica se os sinais entre organizações se aplicam a esta organização. Eles exigem tanto o plano Enterprise quanto o modo de compartilhamento global.
true
Por que os sinais entre organizações não se aplicam, verificados nesta ordem. plan: o plano da organização não inclui a rede antifraude entre organizações (ela exige o plano Enterprise), qualquer que seja o modo de compartilhamento. sharing_mode: o plano a inclui, mas o modo de compartilhamento é private ou off. Nulo quando cross_org_available é true.
plan, sharing_mode null
As tags da sua aplicação na rede, das mais antigas para as mais recentes. Cada aplicação vê apenas as próprias tags. fraud_tags é separado e não muda: as tags que os membros da rede carregam.
Show child attributes
Show child attributes
Situação das pessoas e empresas da rede. Cada membro que você pode ver é contado uma vez, pelo status da sua verificação mais recente que chegou a uma decisão. As partes de transações não são contadas.
Show child attributes
Show child attributes
Pontuações de padrões em toda a rede. Atualmente, um item, background.
Show child attributes
Show child attributes