curl
curl 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/sync-runs/d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.get_sync_run(
"11111111-2222-3333-4444-555555555555",
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.getSyncRun(
"11111111-2222-3333-4444-555555555555",
"11111111-2222-3333-4444-555555555555",
);
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.GetSyncRun(ctx, "11111111-2222-3333-4444-555555555555", "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().getSyncRun("11111111-2222-3333-4444-555555555555", "11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->getSyncRun('11111111-2222-3333-4444-555555555555', '11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.get_sync_run(
"11111111-2222-3333-4444-555555555555",
"11111111-2222-3333-4444-555555555555"
)
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.GetSyncRunAsync("11111111-2222-3333-4444-555555555555", "11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
"connection_id": "5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35",
"trigger": "scheduled",
"status": "succeeded",
"started_at": "2026-11-21T06:00:02Z",
"finished_at": "2026-11-21T06:00:19Z",
"results": [
{
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"resource": "transactions",
"outcome": "succeeded",
"added": 3,
"modified": 0,
"removed": 1,
"error": null
},
{
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"resource": "balances",
"outcome": "succeeded",
"added": 0,
"modified": 0,
"removed": 0,
"error": null
},
{
"account_id": "c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72",
"resource": "transactions",
"outcome": "succeeded",
"added": 0,
"modified": 0,
"removed": 0,
"error": null
}
],
"error": null
}
连接
获取银行同步运行 API:按账户查看结果
Didit 的获取同步运行接口可返回单次同步的结果,包括每个账户和资源的新增、修改、删除数量,或错误信息。
GET
/
v3
/
bank
/
connections
/
{id}
/
sync-runs
/
{sync_id}
/
curl
curl 'https://verification.didit.me/v3/bank/connections/5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35/sync-runs/d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.get_sync_run(
"11111111-2222-3333-4444-555555555555",
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.getSyncRun(
"11111111-2222-3333-4444-555555555555",
"11111111-2222-3333-4444-555555555555",
);
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.GetSyncRun(ctx, "11111111-2222-3333-4444-555555555555", "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().getSyncRun("11111111-2222-3333-4444-555555555555", "11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->getSyncRun('11111111-2222-3333-4444-555555555555', '11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.get_sync_run(
"11111111-2222-3333-4444-555555555555",
"11111111-2222-3333-4444-555555555555"
)
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.GetSyncRunAsync("11111111-2222-3333-4444-555555555555", "11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
"connection_id": "5e1d2a70-3b94-4c1f-8a6e-d2f07b9c1e35",
"trigger": "scheduled",
"status": "succeeded",
"started_at": "2026-11-21T06:00:02Z",
"finished_at": "2026-11-21T06:00:19Z",
"results": [
{
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"resource": "transactions",
"outcome": "succeeded",
"added": 3,
"modified": 0,
"removed": 1,
"error": null
},
{
"account_id": "a71f0c2e-5d38-4b96-a1c4-3e9f8d2b7a10",
"resource": "balances",
"outcome": "succeeded",
"added": 0,
"modified": 0,
"removed": 0,
"error": null
},
{
"account_id": "c3d84e19-2a7b-4f60-b5e1-9a0c6d3f8e72",
"resource": "transactions",
"outcome": "succeeded",
"added": 0,
"modified": 0,
"removed": 0,
"error": null
}
],
"error": null
}
Didit 的“获取同步运行”端点会返回一次同步的结果,其中包含每个账户和资源的结果:新增、修改和删除的数量,或错误信息。
sync_id 来自 刷新连接 或 bank.data.updated Webhook。授权
您的应用 API 密钥,可在 Business Console 的开发者 -> API 密钥中获取。主密钥拥有完全访问权限。命名密钥可以设置范围:可按资源设置无权限、只读或读写,可限定为部分工作流或已批准的会话,可限定为一组 IP 地址,并可设置过期日期。401 表示密钥错误、已被撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或执行该操作,或请求来自其 IP 列表之外的地址;会话相关路由返回 404,表示该会话不在密钥的工作流或状态范围内。没有媒体访问权限的密钥会将图片、视频和 PDF 的 URL 返回为 null;没有会话写入权限的密钥会将会话链接和令牌返回为 null。请参阅 https://docs.didit.me/console/api-keys。
响应
同步运行。
连接的一次同步。仅列出初始同步、定时同步和请求同步。
最后修改于 2026年11月22日