跳转到主要内容
GET
curl
Didit 的 Sync Transactions 端点会返回某个连接自指定游标以来发生变化的交易,包括 added、modified 和 removed。 空游标会返回全部交易,并带上 reset: true。 只有在响应中 has_more: false 时,才应存储 next_cursor。 请参阅面向会计的持续银行数据流。

授权

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。

路径参数

id
string<uuid>
必填

连接 ID。

查询参数

cursor
string

您保存的 next_cursor。为空或省略时从头开始。

limit
integer
默认值:100

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

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

当 has_more 为 true 时,继续同一次读取。

响应

变更列表的一页。

自某个游标之后,连接交易的变更。空游标会将当前所有交易作为 added 返回。同一次读取的所有分页反映同一快照;读取期间发生的变更将在下一次读取中返回。

added
object[]
必填

需要新增的交易。在首次读取时(无游标,或在 reset 之后),这是读取开始时该连接拥有的每一笔交易,每笔仅返回一次,并以其当前状态返回,即使您在分页时同步仍在运行。在后续读取中,此处包含自您的游标以来新增的交易,以及替换待处理交易的已入账交易。

modified
object[]
必填

自您的游标以来发生变化的交易,以其当前状态返回。请按 id 对每条交易执行插入或更新(upsert)操作:在首次读取的分页过程中已收到的交易,如果期间发生了变化,会在此再次返回;银行的更正也会在此返回。

removed
object[]
必填

已不再存在的交易,并附带 reason。忽略您没有的 id:在分页读取首次数据时被删除的交易,仍会以 added 形式投递一次,并在下一次读取中返回。

has_more
boolean
必填

还有更多页时返回 true。仅在响应中 has_more: false 后才存储 next_cursor;若分页中途失败,请从您之前存储的游标重新开始。

next_page_token
string | null
必填

当 has_more 为 true 时,继续本次读取。

next_cursor
string | null
必填

数据源的持久检查点,仅在最后一页返回。该值不透明,并与应用、环境和连接绑定,可重放 90 天。首次读取时,它标记读取开始的时刻,因此在此期间发生的变更会在下一次读取时返回。

reset
boolean
必填

每次初始化读取(即从空游标开始的每次读取)都会返回 true:请用结果替换您的本地副本,而不是追加到其中。

最后修改于 2026年11月22日