跳转到主要内容
GET
curl
Didit 的 List Transactions endpoint 可按日期范围读取账户的交易记录,包括已入账和待处理的交易,并使用基于 page token 的分页。 金额以十进制字符串返回,银行未提供的字段返回 null。 如需保持副本同步,请使用变更流,而不要重复读取日期范围。

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的开发者 -> API 密钥中获取。主密钥拥有完全访问权限。命名密钥可以设置范围:可按资源设置无权限、只读或读写,可限定为部分工作流或已批准的会话,可限定为一组 IP 地址,并可设置过期日期。401 表示密钥错误、已被撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或执行该操作,或请求来自其 IP 列表之外的地址;会话相关路由返回 404,表示该会话不在密钥的工作流或状态范围内。没有媒体访问权限的密钥会将图片、视频和 PDF 的 URL 返回为 null;没有会话写入权限的密钥会将会话链接和令牌返回为 null。请参阅 https://docs.didit.me/console/api-keys。

路径参数

account_id
string<uuid>
必填

账户 ID。

查询参数

date_from
string<date>

要包含的最早生效日期(含当天)。

date_to
string<date>

要包含的最后生效日期(含当日)。省略时不设上限。

status
enum<string>

仅已入账或仅待处理的交易。默认两者都返回。

可用选项:
booked,
pending
limit
integer
默认值:100

每页条数,1 至 500。默认 100。

必填范围: 1 <= x <= 500
page_token
string

上一页的 next_page_token。

响应

交易列表的一页。

日期范围查询的一页。第一页确定包含哪些交易,每笔交易都按其当前状态返回;在翻页期间被移除的交易不会出现在后续页中,并会通过变更流报告。

items
object[]
必填

按 effective_date 降序排序,其次按 id 排序。

next_page_token
string | null
必填

继续本次读取。固定第一页的快照,有效期一小时,并与本次读取的应用、环境、账户和过滤条件绑定。

has_more
boolean
必填
最后修改于 2026年11月22日