curl -X POST 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/refresh/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait=True,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.refreshConnection("11111111-2222-3333-4444-555555555555", {
wait: true,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.RefreshConnection(ctx, "11111111-2222-3333-4444-555555555555", didit.BankRefreshConnectionParams{
Body: didit.BankRefreshRequest{
Wait: didit.Bool(true),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BankRefreshConnectionParams;
import me.didit.types.BankRefreshRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().refreshConnection("11111111-2222-3333-4444-555555555555", BankRefreshConnectionParams.builder()
.wait_(true)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->refreshConnection('11111111-2222-3333-4444-555555555555', [
'wait' => true,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait: true
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.RefreshConnectionAsync("11111111-2222-3333-4444-555555555555", new BankRefreshRequest
{
Wait = true,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
"connection_id": "5e1d2a70-6b3c-4f8e-a1d9-0c7b2e4f8a36",
"trigger": "requested",
"status": "succeeded",
"started_at": "2026-11-21T12:30:02Z",
"finished_at": "2026-11-21T12:30:09Z",
"results": [
{
"account_id": "a71f0c2e-4d85-4b1a-9e63-2f8c0d5b7a14",
"resource": "transactions",
"outcome": "succeeded",
"added": 3,
"modified": 0,
"removed": 1,
"error": null
}
],
"outcome": "succeeded",
"balances_changed": true,
"error": null
}刷新银行连接 API:立即同步
Didit 的刷新银行连接端点可立即同步:返回 202 和 sync_id;若等待最多 25 秒,则返回 200 及已完成的同步结果。
curl -X POST 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/refresh/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait=True,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.refreshConnection("11111111-2222-3333-4444-555555555555", {
wait: true,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.RefreshConnection(ctx, "11111111-2222-3333-4444-555555555555", didit.BankRefreshConnectionParams{
Body: didit.BankRefreshRequest{
Wait: didit.Bool(true),
},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BankRefreshConnectionParams;
import me.didit.types.BankRefreshRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().refreshConnection("11111111-2222-3333-4444-555555555555", BankRefreshConnectionParams.builder()
.wait_(true)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->refreshConnection('11111111-2222-3333-4444-555555555555', [
'wait' => true,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.refresh_connection(
"11111111-2222-3333-4444-555555555555",
wait: true
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.RefreshConnectionAsync("11111111-2222-3333-4444-555555555555", new BankRefreshRequest
{
Wait = true,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
"connection_id": "5e1d2a70-6b3c-4f8e-a1d9-0c7b2e4f8a36",
"trigger": "requested",
"status": "succeeded",
"started_at": "2026-11-21T12:30:02Z",
"finished_at": "2026-11-21T12:30:09Z",
"results": [
{
"account_id": "a71f0c2e-4d85-4b1a-9e63-2f8c0d5b7a14",
"resource": "transactions",
"outcome": "succeeded",
"added": 3,
"modified": 0,
"removed": 1,
"error": null
}
],
"outcome": "succeeded",
"balances_changed": true,
"error": null
}202 和 sync_id。
发送 "wait": true 可最多等待 25 秒,并在一次调用中获得已完成的同步结果,且不额外收费。
由于银行限制无人值守访问,此调用可能返回 429 refresh_limit_reached 以及 Retry-After。
请参阅按需刷新银行数据。授权
您的应用 API 密钥,可在 Business Console 的开发者 -> API 密钥中获取。主密钥拥有完全访问权限。命名密钥可以设置范围:可按资源设置无权限、只读或读写,可限定为部分工作流或已批准的会话,可限定为一组 IP 地址,并可设置过期日期。401 表示密钥错误、已被撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或执行该操作,或请求来自其 IP 列表之外的地址;会话相关路由返回 404,表示该会话不在密钥的工作流或状态范围内。没有媒体访问权限的密钥会将图片、视频和 PDF 的 URL 返回为 null;没有会话写入权限的密钥会将会话链接和令牌返回为 null。请参阅 https://docs.didit.me/console/api-keys。
请求头
您为单次操作选择的可选重试安全密钥,最长 255 个字符(可使用 UUID)。使用相同密钥、endpoint、查询参数和请求体重复发送的请求,会返回第一次的响应,状态码和响应体均相同,且不会再次运行或计费。同一密钥若用于其他 endpoint、查询参数或请求体,将返回 409 idempotency_key_reused;若第一个请求仍在处理中,则返回 409 idempotency_key_in_progress 及 Retry-After。失败的请求(任何 4xx 或 5xx)不会被存储,因此您可以使用相同密钥再次发送。无论您使用 API 密钥还是访问 token 调用,密钥都归属于您的应用。请参阅重试与幂等性。
1 - 255请求体
响应
同步在 25 秒内完成。
由带 wait 的刷新返回的已完成同步:同步运行记录,包含其 outcome、results 中的各账户数量以及 balances_changed。