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، أو 200 مع المزامنة المكتملة عند الانتظار حتى 25 ثانية.
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 الخاص بتطبيقك، ويمكن الحصول عليه من Developers -> API keys في Business Console. يملك المفتاح الأساسي صلاحية وصول كاملة. يمكن تقييد المفتاح المسمّى: بلا صلاحية، أو قراءة، أو كتابة لكل مورد، ويمكن قصره على بعض سير العمل أو على الجلسات المعتمدة، وعلى قائمة من عناوين IP، وعلى تاريخ انتهاء. يعني الرمز 401 أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية. ويعني الرمز 403 أنه لم يُرسل أي مفتاح، أو أن المفتاح لا يملك صلاحية لهذا المورد أو الإجراء، أو أن الطلب صدر من عنوان خارج قائمة IP الخاصة به. ويعني الرمز 404 على مسار جلسة أن الجلسة خارج سير عمل المفتاح أو حالاته المسموح بها. يتلقى المفتاح الذي لا يملك وصولًا إلى الوسائط عناوين URL للصور والفيديو وملفات PDF بقيمة 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 الوصول. راجع إعادة المحاولة وidempotency.
1 - 255الجسم
نص اختياري لطلب التحديث.
true يُبقي الطلب معلقاً لمدة تصل إلى 25 ثانية ويُجيب بـ 200 مع المزامنة المكتملة، فيعيد الطلب الواحد بيانات حديثة. إذا لم يرد البنك خلال تلك المدة يُجيب الطلب بـ 202: اقرأ المزامنة باستخدام get_sync_run مع sync_id، أو اشترك في bank.sync.completed. يُرسل bank.data.updated فقط عندما تخزّن المزامنة تغييرات. يؤدي الرأس Prefer: wait=<seconds> (حتى 25) الوظيفة نفسها.
الاستجابة
انتهت المزامنة خلال 25 ثانية.
مزامنة مكتملة تعيدها عملية تحديث مع wait: تشغيل المزامنة مع outcome الخاص بها، وأعداد كل حساب في results وbalances_changed.