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 للحصول على تشغيل مزامنة بنكية: النتائج لكل حساب
تُرجع نقطة Get a Sync Run من Didit تشغيل مزامنة واحدًا مع نتيجته لكل حساب ومورد: عدد الإضافات والتعديلات والحذوفات، أو الخطأ.
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
}sync_id من تحديث الاتصال أو من الـ webhook bank.data.updated.التفويضات
مفتاح API الخاص بتطبيقك، ويمكن الحصول عليه من Developers -> API keys في Business Console. يملك المفتاح الأساسي صلاحية وصول كاملة. يمكن تقييد المفتاح المسمّى: بلا صلاحية، أو قراءة، أو كتابة لكل مورد، ويمكن قصره على بعض سير العمل أو على الجلسات المعتمدة، وعلى قائمة من عناوين IP، وعلى تاريخ انتهاء. يعني الرمز 401 أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية. ويعني الرمز 403 أنه لم يُرسل أي مفتاح، أو أن المفتاح لا يملك صلاحية لهذا المورد أو الإجراء، أو أن الطلب صدر من عنوان خارج قائمة IP الخاصة به. ويعني الرمز 404 على مسار جلسة أن الجلسة خارج سير عمل المفتاح أو حالاته المسموح بها. يتلقى المفتاح الذي لا يملك وصولًا إلى الوسائط عناوين URL للصور والفيديو وملفات PDF بقيمة null، ويتلقى المفتاح الذي لا يملك صلاحية كتابة الجلسات روابط الجلسات والرموز بقيمة null. راجع https://docs.didit.me/console/api-keys.
الاستجابة
تشغيل المزامنة.
مزامنة واحدة لربط. تُدرج المزامنات الأولية والمجدولة والمطلوبة فقط.