欺诈网络时间线 API

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."
      }
    }
  ]
}

获取某个网络的事件历史。不传 contract 时，响应返回网络自身的历史记录，按时间从旧到新排列且不分页：包括网络首次被检测到的时间、每个信号最近一次被观察到的时间，以及网络最近一次状态变更及其原因。此结构保持不变，limit、cursor 和 event_type 会被忽略。

类型化时间线

如需读取类型化时间线，请传入 contract=2。时间线会额外包含成员账户的行为，以及贵团队针对该网络采取的操作，按时间从新到旧排列，每次返回一页。 contract 只接受 2；其他任何值都会返回 400。

参数	含义
`limit`	每页事件数，范围 1 到 500。默认值为 100。
`cursor`	上一页的 `next_cursor`。无效或为空的游标会返回 `400`。
`event_type`	要保留的事件类型，可重复传入或用逗号分隔，最多 20 个值。默认包含所有类型。

响应格式为 {"results": [...], "next_cursor": "..."}。将 cursor 设为 next_cursor 即可读取下一页，直到 next_cursor 为 null 为止。

事件类型

`event_type`	记录内容	详情块
`network_detected`	网络被检测到	无
`signal_observed`	信号的最新观察记录	无
`network_active`, `network_in_review`, `network_resolved`, `network_dismissed`	网络的最新状态变更，其原因记录在 `metadata` 中	无
`verification_attempt`	成员（个人或企业）的一次验证会话，带序号（第 `attempt` 次，共 `attempt_count` 次），若被拒绝则包含拒绝原因	`verification_attempt`
`transaction`	成员参与的一笔交易，按交易日期记录	`transaction`
`login`	您通过事件 API 为成员发布的一次登录或登录失败	`login`
`rule_hit`	命中成员交易或事件的生效规则	`rule_hit`
`case_linked`	贵组织为该网络创建的一个案件	`case_linked`
`note_added`	添加到该网络上的备注，不含备注内容	`note_added`

note_added 事件仅返回给控制台成员，绝不会返回给 API 密钥。两名成员之间的交易会分别针对每位成员各出现一次，每条记录都带有各自的 account。该交易的一次规则命中只出现一次。登录事件仅针对您作为事件发布的登录记录存在：auth.login、security.login_succeeded 及其失败形式。

账户与记录

每条成员事件都包含 account（其所属的成员）和 source_ref（读取该事件所依据的会话、企业会话、交易、监控事件或案件）。 ownership 在记录属于您调用的应用时为 owned，当记录属于贵组织的其他应用时为 organization。 route 给出记录的类型、UUID 和应用；对于监控事件或案件，source_ref 不包含 route。网络自身的事件既不包含 account，也不包含 source_ref。

​类型化时间线

​事件类型

​账户与记录

​相关内容

授权

路径参数

查询参数

响应

类型化时间线

事件类型

账户与记录

相关内容