跳转到主要内容
GET
curl
Didit 的获取账户 endpoint 会返回单个账户的信息,包括其标识符、持有人、同步时效和历史数据覆盖范围。 sync.last_synced_at 表示 Didit 最后一次从银行获取数据的时间。 获取完整标识符需要您的 API 密钥具备银行数据权限。 请参阅账户、余额和交易。

授权

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。

响应

账户。

连接中的一个账户。

id
string<uuid>
必填

账户 ID。归属于该连接,只要连接存在便永不变更,续期后也不变。

connection_id
string<uuid>
必填
name
string | null
必填
product
string | null
必填

银行的产品名称。

type
enum<string>
必填
可用选项:
current,
savings,
card,
loan,
investment,
other
usage
enum<string>
必填
可用选项:
personal,
business,
unknown
currency
string
必填

ISO 4217 货币代码。

Pattern: ^[A-Z]{3}$
holder_name
string | null
必填

银行提供时的账户持有人姓名。

holders
object[]
必填

银行提供的持有人信息。所有权仅统计 holder 和 joint_holder。

identifiers
object
必填

完整标识符,仅在拥有银行数据权限时返回给服务端调用方。

account_ref
string | null
必填

用于在同一应用和环境的不同连接之间识别同一银行账户:是对银行自身标识符计算的带密钥哈希值。银行未提供可靠标识符时为 null。可用于识别您已知的银行账户。

account_ref_previous
string | null
必填

之前的 account_ref,仅适用于已验证的别名,例如银行迁移的情况。

status
enum<string>
必填

access_removed:用户从同意中移除了该账户。该账户不再同步。

可用选项:
open,
closed,
access_removed
scopes_granted
enum<string>[]
必填
可用选项:
accounts,
balances,
transactions
sync
object
必填
history_coverage
object
必填

银行实际返回的您所请求的历史数据。

最后修改于 2026年11月22日