Saltar para o conteúdo principal
GET
curl
Obtenha uma rede com tudo o que é necessário para apresentar o painel de visão geral da rede: a respetiva decomposição de risco, as etiquetas de fraude detetadas e os resumos dos sinais de risco, para além dos campos partilhados com a lista. O detalhe inclui também as etiquetas da sua aplicação na rede, o estado das verificações dos respetivos membros e o grau de semelhança entre os fundos das selfies.

Etiquetas

tags lista as etiquetas da sua aplicação na rede, da mais antiga para a mais recente. Cada aplicação vê e altera apenas as suas próprias etiquetas. added_by é o e-mail do membro da consola que adicionou a etiqueta, ou null quando foi uma chave de API a adicioná-la. Use Adicionar etiqueta à rede e Remover etiqueta da rede para as alterar. fraud_tags não muda: lista as etiquetas que os membros da rede têm.

Resultados dos membros

outcomes conta as pessoas e empresas da rede que pode ver, contando cada uma apenas uma vez. Um membro recusado e depois aprovado numa nova tentativa conta como approved. Um membro cujas verificações estejam todas por decidir (não iniciadas, em curso, expiradas ou abandonadas) conta apenas em total. As partes nas transações não passam por nenhuma verificação e não são contadas.

Padrão de fundo da selfie

patterns contém, neste momento, um item, com type definido como background. O seu score, de 0 a 1, é a média da semelhança de 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 local. Paredes lisas de cor semelhante também podem obter uma pontuação elevada, por isso trate a pontuação como um indício para revisão, e não como prova. A pontuação analisa a selfie mais recente de cada pessoa, no máximo as 50 mais recentes, e deixa de fora as sessões de verificação de idade. Abrange a rede inteira, e não apenas os membros das suas aplicações. Uma selfie que não possa ser lida, ou que mostre fundo insuficiente, não é comparada, pelo que members pode ser inferior ao número de pessoas na rede. A pontuação descreve sempre as selfies atuais dos membros. Quando estas mudam, por exemplo quando um membro entra ou sai, o detalhe indica computing até a nova pontuação estar pronta, ou not_enough_selfies quando restam menos de dois.

Disponibilidade entre organizações

O detalhe inclui os mesmos sharing_mode, cross_org_available e cross_org_unavailable_reason que listar redes. Os sinais entre organizações exigem simultaneamente o plano Enterprise e o modo de partilha global.

Relacionados

Autorizações

x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, 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á incorreta, 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 o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

organization_id
string<uuid>
obrigatório

UUID da organização.

application_id
string<uuid>
obrigatório

UUID da aplicação.

network_uuid
string<uuid>
obrigatório

UUID da rede.

Exemplo:

"n3a5e000-0000-4000-8000-000000000001"

Resposta

Detalhe da rede.

Os detalhes da rede, mais o modo de partilha da organização, se os sinais entre organizações se aplicam à mesma, as etiquetas da sua aplicação na rede, os resultados dos membros e as pontuações de padrões.

uuid
string<uuid>
network_id
string

ID sequencial legível por humanos por organização, ex.: N-0001.

name
string | null
status
enum<string>

Estado do ciclo de vida da rede. Distinto do outcome_status por requerente dentro de uma rede (approved/in_review/declined/not_completed).

Opções disponíveis:
active,
in_review,
resolved,
dismissed
risk
object
pattern_types
enum<string>[]

Os padrões de agrupamento detetados nesta rede.

Opções disponíveis:
exact_same_device,
similar_device,
same_ip_address,
same_address,
similar_selfie_backgrounds,
similar_poa_documents,
same_document_number,
same_phone_number,
same_email
signal_types
enum<string>[]

Os tipos de sinal distintos presentes nesta rede.

Opções disponíveis:
ip_address,
device,
face,
document_number,
phone,
email,
address
member_counts
object

Contagens de membros por categoria (por ex., total, por outcome_status).

member_status
object

Distribuição de membros por outcome_status.

signal_coverage
object

Cobertura dos membros desta rede por signal_type.

first_activity_at
string<date-time> | null
last_activity_at
string<date-time> | null
stats
object

Estatísticas agregadas para a rede (por exemplo, totais de membros).

fraud_tags
object[]

Etiquetas de padrões de fraude identificadas na rede.

risk_signals
object

Resumos de sinais de risco: residential_proxy_reuse, email_intelligence, phone_intelligence.

reviewed_at
string<date-time> | null
reviewed_by
string | null
review_reason
string | null
notes_count
integer
read-only

Número de notas privadas do analista nesta investigação.

Intervalo necessário: x >= 0
sharing_mode
enum<string>

O modo de partilha entre organizações da organização. Apenas global compara redes entre organizações; private e off restringem-nas ao próprio histórico da organização.

Opções disponíveis:
off,
private,
global
Exemplo:

"global"

cross_org_available
boolean

Se os sinais entre organizações se aplicam a esta organização. Exigem tanto o plano Enterprise como o modo de partilha global.

Exemplo:

true

cross_org_unavailable_reason
enum<string> | null

O motivo pelo qual os sinais interorganizacionais não se aplicam, verificados por esta ordem. plan: o plano da organização não inclui a rede de fraude interorganizacional (requer o plano Enterprise), independentemente do modo de partilha. sharing_mode: o plano inclui-a, mas o modo de partilha é private ou off. Nulo quando cross_org_available é true.

Opções disponíveis:
plan,
sharing_mode
Exemplo:

null

tags
object[]

As etiquetas da sua aplicação na rede, as mais antigas primeiro. Cada aplicação vê apenas as suas próprias etiquetas. fraud_tags é separado e não se altera: as etiquetas que os membros da rede possuem.

outcomes
object

O estado em que se encontram as pessoas e empresas da rede. Cada membro que possa ver conta uma vez, pelo estado da sua verificação mais recente que tenha chegado a uma decisão. As partes da transação não são contabilizadas.

patterns
object[]

Pontuações de padrão em toda a rede. Atualmente um item, background.

Última modificação em 7 de novembro de 2026