跳转到主要内容
GET
curl
列出应用的案件,默认按最新排序。控制台案件列表中可用的每个筛选和排序选项都以查询参数的形式开放,包括对主体、标签、案件编号以及关联会话或交易 ID 的全文搜索(search)。 每个案件还包含其所属团队(team)、待处理四眼原则决议中指定的审核人(checker),以及主体的国家/地区(country)和头像(portrait)。

访问权限

案件相关 endpoint 需要具有完全访问权限的 API 密钥。 权限受限的密钥会收到 403。

相关内容

授权

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。

查询参数

limit
integer
默认值:50

页面大小。默认为 50。

必填范围: x >= 1
offset
integer
默认值:0

第一条记录的从零开始的偏移量。

必填范围: x >= 0
status__in
string

要包含的状态列表(以逗号分隔),例如 OPEN,AWAITING_USER。

priority
string

要包含的优先级列表(以逗号分隔)。

source__in
string

要包含的来源列表(以逗号分隔)。

blueprint
string<uuid>

过滤此蓝图下的案件。

assigned_to
string<uuid>

过滤分配给该用户的案件。

unassigned
boolean

未分配的案件为 true,已分配的案件为 false。

tag
string

过滤带有此完全相同标签的案件。

匹配 title、case_number、tag、主体姓名/UUID/外部 ID、关联的会话 UUID 或关联的交易 UUID。

date_from
string<date>

创建时间下限(含)。

date_to
string<date>

创建时间上限(含)。

due_before
string<date-time>

due_at 上限。

overdue
boolean

为 true 则仅返回逾期的 open/awaiting-user 案件。

ordering
enum<string>
默认值:-created_at

排序顺序。due_at 将 null 排在最后。

可用选项:
created_at,
-created_at,
due_at,
-due_at

响应

200 - application/json

分页案件列表。

count
integer

匹配的行数。100 以内为准确数值,超过 100 时出于性能考虑封顶显示为 100。请根据 next 为 null 来判断是否为最后一页。

next
string | null

下一页的绝对 URL,或者 null。

previous
string | null

上一页的绝对 URL,或者 null。

results
object[]
最后修改于 2026年11月7日