> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 银行数据 API：链接、连接、账户与交易

> Didit 银行数据 API 全部端点：创建银行链接、管理连接、读取账户、余额和交易、订阅变更动态，并查询银行信息。

Didit 的 Bank data API 通过 Bank Link 连接用户的银行账户，在用户允许的期限内保持连接有效，并提供其账户、余额和交易数据。
基础 URL 为 `https://verification.didit.me/v3/`，与所有独立 API 一样，通过 `x-api-key` 请求头使用您的应用 API 密钥进行身份验证。

所有写入操作都接受 `Idempotency-Key`。列表接口接受 `limit`（默认 100，最大 500），并通过 `cursor` 继续获取下一页；交易读取接口除外：日期范围读取通过 `page_token` 继续获取下一页，变更流接受持久的 `cursor`，并通过 `page_token` 继续获取下一页。读取操作不产生费用。
错误信息包含 `code`、`message`、`request_id`、`field`、`next_action` 和 `retry_after`：请根据 `code` 进行分支处理。
除账户核验外，所有操作都需要带有 Bank data 权限的 API 密钥，完全访问权限不包含该权限。
[账户核验](https://docs.didit.me/zh/standalone-apis/bank-account-check.md)不使用该权限，它需要具有会话写入权限的 API 密钥，或具有完全访问权限的 API 密钥。
Bank data API 可用于沙盒应用。生产环境应用的调用在正式访问权限公布之前将返回 `404`。沙盒环境中不收取任何费用。

## 链接

> [card] [创建链接](https://docs.didit.me/zh/standalone-apis/bank-link-create.md)
>
> `POST /v3/bank/links/`

> [card] [获取链接](https://docs.didit.me/zh/standalone-apis/bank-link-get.md)
>
> `GET /v3/bank/links/{id}/`

> [card] [取消链接](https://docs.didit.me/zh/standalone-apis/bank-link-cancel.md)
>
> `POST /v3/bank/links/{id}/cancel/`

## 连接

> [card] [列出连接](https://docs.didit.me/zh/standalone-apis/bank-connections-list.md)
>
> `GET /v3/bank/connections/`

> [card] [获取连接](https://docs.didit.me/zh/standalone-apis/bank-connection-get.md)
>
> `GET /v3/bank/connections/{id}/`

> [card] [刷新](https://docs.didit.me/zh/standalone-apis/bank-connection-refresh.md)
>
> `POST /v3/bank/connections/{id}/refresh/`

> [card] [续期](https://docs.didit.me/zh/standalone-apis/bank-connection-renew.md)
>
> `POST /v3/bank/connections/{id}/renew/`

> [card] [撤销](https://docs.didit.me/zh/standalone-apis/bank-connection-revoke.md)
>
> `POST /v3/bank/connections/{id}/revoke/`

> [card] [删除](https://docs.didit.me/zh/standalone-apis/bank-connection-delete.md)
>
> `DELETE /v3/bank/connections/{id}/`

> [card] [同步运行记录](https://docs.didit.me/zh/standalone-apis/bank-sync-runs-list.md)
>
> `GET /v3/bank/connections/{id}/sync-runs/`

> [card] [获取同步运行记录](https://docs.didit.me/zh/standalone-apis/bank-sync-run-get.md)
>
> `GET /v3/bank/connections/{id}/sync-runs/{sync_id}/`

## 账户、余额和交易

> [card] [列出账户](https://docs.didit.me/zh/standalone-apis/bank-accounts-list.md)
>
> `GET /v3/bank/connections/{id}/accounts/`

> [card] [获取账户](https://docs.didit.me/zh/standalone-apis/bank-account-get.md)
>
> `GET /v3/bank/accounts/{account_id}/`

> [card] [获取余额](https://docs.didit.me/zh/standalone-apis/bank-account-balances.md)
>
> `GET /v3/bank/accounts/{account_id}/balances/`

> [card] [列出交易](https://docs.didit.me/zh/standalone-apis/bank-account-transactions.md)
>
> `GET /v3/bank/accounts/{account_id}/transactions/`

> [card] [交易变更流](https://docs.didit.me/zh/standalone-apis/bank-transactions-sync.md)
>
> `GET /v3/bank/connections/{id}/transactions/sync/`

## 银行与覆盖范围

> [card] [列出机构](https://docs.didit.me/zh/standalone-apis/bank-institutions-list.md)
>
> `GET /v3/bank/institutions/`

> [card] [获取机构](https://docs.didit.me/zh/standalone-apis/bank-institution-get.md)
>
> `GET /v3/bank/institutions/{id}/`

> [card] [获取覆盖范围](https://docs.didit.me/zh/standalone-apis/bank-coverage.md)
>
> `GET /v3/bank/coverage/`

> [card] [账户核验](https://docs.didit.me/zh/standalone-apis/bank-account-check.md)
>
> `POST /v3/bank/account-check/`

## 指南

* [银行数据快速入门](https://docs.didit.me/zh/core-technology/bank-verification/quickstart.md)
* [连接](https://docs.didit.me/zh/core-technology/bank-verification/connections.md)
* [账户、余额与交易](https://docs.didit.me/zh/core-technology/bank-verification/accounts-balances-transactions.md)
* [银行 Webhook](https://docs.didit.me/zh/core-technology/bank-verification/webhooks.md)
* [沙盒](https://docs.didit.me/zh/core-technology/bank-verification/sandbox.md)
* [定价](https://docs.didit.me/zh/getting-started/bank-verification-pricing.md)

## 服务端 SDK

七个服务端 SDK 都在 `bank` 资源下提供以下操作，每个操作的方法均以该操作的名称命名，例如 `create_link`、`get_connection`、`sync_transactions` 等。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.