Saltar para o conteúdo principal
POST
curl
Coloque uma das etiquetas da sua aplicação numa rede, por exemplo para a marcar para seguimento ou para registar a conclusão da sua equipa. Indique o UUID da etiqueta, retirado das etiquetas da sua aplicação, como tag_uuid. Uma etiqueta que pertença a outra aplicação devolve 404, tal como uma etiqueta que não existe. A resposta é o detalhe completo da rede, com 201 quando a etiqueta foi adicionada e 200 quando já estava na rede. Voltar a chamar o endpoint com a mesma etiqueta não altera nada, por isso pode tentar novamente sem risco. tags lista as etiquetas da sua aplicação na rede, da mais antiga para a mais recente. added_by é null quando uma chave de API adicionou a etiqueta, e o e-mail do membro da consola quando foi um membro a adicioná-la. As fraud_tags da rede, as etiquetas que os respetivos membros têm, não são afetadas.

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:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Corpo

application/json
tag_uuid
string<uuid>
obrigatório

UUID de uma das etiquetas da sua aplicação.

Resposta

A etiqueta já se encontrava na rede e foi mantida como estava. Devolve os detalhes 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