跳转到主要内容
GET
curl
Didit 的“获取同步运行”端点会返回一次同步的结果,其中包含每个账户和资源的结果:新增、修改和删除的数量,或错误信息。 sync_id 来自 刷新连接 或 bank.data.updated Webhook。

授权

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。

sync_id
string<uuid>
必填

同步运行的 id。

响应

同步运行。

连接的一次同步。仅列出初始同步、定时同步和请求同步。

id
string<uuid>
必填
connection_id
string<uuid>
必填
trigger
enum<string>
必填
可用选项:
initial,
scheduled,
requested
status
enum<string>
必填
可用选项:
queued,
running,
succeeded,
partial,
failed
started_at
string<date-time> | null
必填
finished_at
string<date-time> | null
必填
results
object[]
必填

本次运行按账户和资源分别执行了什么。

error
object | null
必填

整个运行失败的原因。未失败时为 null。单个账户和资源的错误见 results。

最后修改于 2026年11月22日