跳转到主要内容
POST
curl
每个案件必须且只能关联一个主体。可直接提供 subject,或提供 links,由 Didit 根据第一个关联实体的所有者推导出主体。
只要有 blueprint,就应传入。它决定案件页面渲染哪些部分、解决案件时是否必须填写备注,以及案件在升级或转移时的流转去向。

相关内容

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。

路径参数

organization_id
string<uuid>
必填

组织 UUID。

application_id
string<uuid>
必填

应用 UUID。

请求体

application/json
title
string
必填
Maximum string length: 255
blueprint
string<uuid> | null

CaseBlueprint UUID。省略则表示无蓝图。

priority
enum<string>
默认值:MEDIUM
可用选项:
LOW,
MEDIUM,
HIGH
due_at
string<date-time> | null
tags
string[]
subject
object

除非提供了 links,否则为必填项;案件的唯一主体。

创建时要附加的会话/企业会话/交易,例如 [{"entity_type": "transaction", "entity_uuid": "..."}]。当省略主体时,主体将派生自第一个关联的所有者。

assigned_to
string<uuid> | null

要立即分配的用户 UUID。

review_duplicates
boolean
默认值:false

在创建案件前重新检查现有的调查。若为 true,存在现有案件的主体必须提供非空的 separate_incident_reason。控制台始终启用此保护。省略该参数将保留现有的 API 行为。

separate_incident_reason
string
Maximum string length: 1000
source_context
object

响应

案件已创建。

uuid
string<uuid>
case_number
string | null
title
string
status
enum<string>
可用选项:
OPEN,
AWAITING_USER,
RESOLVED
resolution
enum<string> | null
可用选项:
FALSE_POSITIVE,
VALID_THREAT,
INCONCLUSIVE,
REQUIREMENTS_NOT_MET,
REQUIREMENTS_SATISFIED
resolution_notes
string | null
priority
enum<string>
可用选项:
LOW,
MEDIUM,
HIGH
source
enum<string>
可用选项:
MANUAL,
AML_SCREENING,
TRANSACTION_RULE,
WORKFLOW_BUILDER
tags
string[]
subject
object | null

该案件所绑定的单个用户或企业。

assigned_to
object | null
assigned_at
string<date-time> | null
team
object | null

负责该案件的审核团队;没有团队负责时为 null。当路由规则将案件分配给其团队之一时,路由系统会对其进行设置。使用 PATCH .../cases/{case_uuid}/(team)进行修改或清除。

due_at
string<date-time> | null
resolved_at
string<date-time> | null
resolved_by_email
string | null
pending_resolution
object | null

仅在双人复核(4-eyes)决议暂存于审核员蓝图、等待批准或拒绝批准时设置。

checker
object | null

被指定批准或拒绝待决决定的成员。仅当双人复核(four-eyes)决议等待指定复核员时设置。在无待决事项、待决决议在复核员队列中等待,以及决议已获批准、被拒绝或因证据变更而退回重新审核后,该值为 null。

metadata
object
blueprint
object
notes
object[]

最新的 50 条备注。

events
object[]

最新的 100 个事件。

notes_count
integer
checklist_items
object[]
created_at
string<date-time>
updated_at
string<date-time>
最后修改于 2026年11月7日