跳转到主要内容
GET
curl
备注记录了交易的分析师时间线,与审核员在 交易详情 中 备注 下看到的列表相同。您可以使用 创建交易备注 添加自己的备注,并使用 获取交易 读取交易本身,包括其 activities。 当 actor_name 为 Rule Engine 时,该备注来自 Didit:可能是规则的 add_note 操作,也可能是为处于 AWAITING_USER 状态的交易创建用户操作验证会话时出现问题(会话无法创建,或 Didit 改用了其他工作流)。

授权

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。

路径参数

transaction_id
string<uuid>
必填

Didit 交易 UUID:由 POST /v3/transactions/ 和 GET /v3/transactions/ 返回的 uuid。不接受您自己的 txn_id。

查询参数

limit
integer
默认值:50

每页备注数量。默认为 50。非正整数值将回退为 50;大于 1000000 的值将返回 400。

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

要返回的第一条备注的从零开始的位置。建议跟随 next。非整数值将回退为 0;大于 1000000 的值将返回 400。

必填范围: 0 <= x <= 1000000

响应

一页备注,按最新优先排序。

count
integer
必填

该交易的备注数量:100 以内为准确数值,超过 100 时封顶显示为 100。请依据 next 进行翻页,而不是据此计算总页数。

next
string<uri> | null
必填

下一页的绝对 URL,最后一页则为 null。

previous
string<uri> | null
必填

上一页的绝对 URL,第一页则为 null。

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