API de Cronologia da Rede de Fraude

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/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

GET

organization

{organization_id}

application

{application_id}

networks

{network_uuid}

timeline

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/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

Obtenha o histórico de eventos de uma rede. Sem contract, a resposta é o histórico da própria rede, do mais antigo para o mais recente e sem paginação: quando foi detetada pela primeira vez, quando cada sinal foi observado pela última vez e a sua última alteração de estado com o respetivo motivo. Esta estrutura não mudou, e limit, cursor e event_type são ignorados.

Linha temporal tipada

Passe contract=2 para ler a linha temporal tipada. Esta inclui o que as contas dos membros fizeram e o que a sua equipa fez em relação à rede, do mais recente para o mais antigo, uma página de cada vez. contract aceita apenas 2; qualquer outro valor devolve 400.

Parâmetro	Significado
`limit`	Eventos por página, de 1 a 500. Por defeito, 100.
`cursor`	O `next_cursor` da página anterior. Um cursor inválido ou vazio devolve `400`.
`event_type`	Os tipos de evento a manter, repetidos ou separados por vírgulas, até 20 valores. Por defeito, todos os tipos.

A resposta é {"results": [...], "next_cursor": "..."}. Leia a página seguinte com cursor definido como next_cursor, até que next_cursor seja null.

Tipos de evento

`event_type`	O que regista	Bloco de detalhe
`network_detected`	A rede foi detetada	Nenhum
`signal_observed`	A observação mais recente de um sinal	Nenhum
`network_active`, `network_in_review`, `network_resolved`, `network_dismissed`	A alteração de estado mais recente da rede, com o respetivo motivo em `metadata`	Nenhum
`verification_attempt`	Uma sessão de verificação de um membro (uma pessoa ou uma empresa), numerada (`attempt` de `attempt_count`), com os motivos de recusa quando foi recusada	`verification_attempt`
`transaction`	Uma transação em que um membro participou, com a data da transação	`transaction`
`login`	Um início de sessão ou um início de sessão falhado que publicou para um membro através da API de eventos	`login`
`rule_hit`	Uma regra ativa que correspondeu a uma transação ou evento de um membro	`rule_hit`
`case_linked`	Um caso aberto para a rede na sua organização	`case_linked`
`note_added`	Uma nota deixada na rede, sem o seu texto	`note_added`

Os eventos note_added são devolvidos apenas aos membros da consola, nunca a uma chave de API. Uma transação entre dois membros aparece uma vez para cada um deles, cada uma com a sua própria account. Uma ocorrência de regra sobre essa transação aparece uma só vez. Os eventos de início de sessão existem apenas para os inícios de sessão que publica como eventos: auth.login, security.login_succeeded e as suas formas falhadas.

Contas e registos

Cada evento de membro inclui account, o membro a que pertence, e source_ref, a sessão, sessão de empresa, transação, evento de monitorização ou caso de onde foi lido. ownership é owned quando o registo pertence à aplicação que chamou, e organization quando pertence a outra aplicação da sua organização. route indica o tipo do registo, o UUID e a aplicação; source_ref não tem route para um evento de monitorização ou um caso. Os eventos da própria rede não incluem account nem source_ref.

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"

Parâmetros de consulta

contract

enum<string>

2 devolve a cronologia tipada. Omita-o para a cronologia predefinida. Qualquer outro valor devolve 400.

Opções disponíveis:

2

limit

integer

padrão:100

Apenas cronologia tipificada. Eventos por página, entre 1 e 500. O valor predefinido é 100.

Intervalo necessário: 1 <= x <= 500

cursor

string

Apenas cronologia tipificada. O next_cursor da página anterior. Um cursor inválido ou vazio devolve 400.

event_type

enum<string>[]

Apenas cronologia tipificada. Tipos de eventos a manter, repetidos ou separados por vírgulas, no máximo 20 valores. O valor predefinido inclui todos os tipos.

Maximum array length: 20

Opções disponíveis:

network_detected,

signal_observed,

network_active,

network_in_review,

network_resolved,

network_dismissed,

verification_attempt,

transaction,

login,

rule_hit,

case_linked,

note_added

Resposta

Sem contract: {results}, os mais antigos primeiro, sem paginação. Com contract=2: {results, next_cursor}, os mais recentes primeiro.

Default timeline (no contract)
Typed timeline page (contract=2)

Sem contract: os eventos próprios da rede, do mais antigo para o mais recente, sem paginação.

results

object[]

Show child attributes

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

​Linha temporal tipada

​Tipos de evento

​Contas e registos

​Relacionados

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta

Linha temporal tipada

Tipos de evento

Contas e registos

Relacionados