الانتقال إلى المحتوى الرئيسي
GET
curl
يُرجع endpoint ‏Get an Account في Didit حسابًا واحدًا مع معرّفاته وحامليه وحداثة بيانات المزامنة وتغطية السجل. sync.last_synced_at هو وقت آخر جلبٍ للبيانات من البنك بواسطة Didit. تتطلب المعرّفات الكاملة إذن بيانات البنك على مفتاح API الخاص بك. راجع الحسابات والأرصدة والمعاملات.

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، ويمكن الحصول عليه من Developers -> API keys في Business Console. يملك المفتاح الأساسي صلاحية وصول كاملة. يمكن تقييد المفتاح المسمّى: بلا صلاحية، أو قراءة، أو كتابة لكل مورد، ويمكن قصره على بعض سير العمل أو على الجلسات المعتمدة، وعلى قائمة من عناوين IP، وعلى تاريخ انتهاء. يعني الرمز 401 أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية. ويعني الرمز 403 أنه لم يُرسل أي مفتاح، أو أن المفتاح لا يملك صلاحية لهذا المورد أو الإجراء، أو أن الطلب صدر من عنوان خارج قائمة IP الخاصة به. ويعني الرمز 404 على مسار جلسة أن الجلسة خارج سير عمل المفتاح أو حالاته المسموح بها. يتلقى المفتاح الذي لا يملك وصولًا إلى الوسائط عناوين URL للصور والفيديو وملفات PDF بقيمة null، ويتلقى المفتاح الذي لا يملك صلاحية كتابة الجلسات روابط الجلسات والرموز بقيمة null. راجع https://docs.didit.me/console/api-keys.

معلمات المسار

account_id
string<uuid>
مطلوب

معرّف الحساب.

الاستجابة

الحساب.

حساب واحد داخل الربط.

id
string<uuid>
مطلوب

معرّف الحساب. يتبع الاتصال ولا يتغير طالما وُجد، بما في ذلك عمليات التجديد.

connection_id
string<uuid>
مطلوب
name
string | null
مطلوب
product
string | null
مطلوب

اسم المنتج المصرفي.

type
enum<string>
مطلوب
الخيارات المتاحة:
current,
savings,
card,
loan,
investment,
other
usage
enum<string>
مطلوب
الخيارات المتاحة:
personal,
business,
unknown
currency
string
مطلوب

رمز العملة وفق ISO 4217.

Pattern: ^[A-Z]{3}$
holder_name
string | null
مطلوب

اسم صاحب الحساب حيثما يشاركه البنك.

holders
object[]
مطلوب

أصحاب الحساب الذين يشاركهم البنك. تُحتسب الملكية فقط للقيمتين holder وjoint_holder.

identifiers
object
مطلوب

المعرّفات الكاملة، وتُعاد للمستدعين من جانب الخادم الذين يملكون إذن بيانات البنك.

account_ref
string | null
مطلوب

يحدد الحساب البنكي نفسه عبر الاتصالات ضمن تطبيق واحد وبيئة واحدة، وهو تجزئة مفتاحية لمعرّفات البنك نفسها. تكون null عندما لا يقدم البنك معرّفاً موثوقاً. استخدمه للتعرف على حساب بنكي تعرفه بالفعل.

account_ref_previous
string | null
مطلوب

قيمة account_ref السابقة، وتظهر فقط للاسم المستعار الموثّق، مثل ترحيل بنكي.

status
enum<string>
مطلوب

access_removed: أزال الشخص الحساب من الموافقة. لم يعد يُزامَن.

الخيارات المتاحة:
open,
closed,
access_removed
scopes_granted
enum<string>[]
مطلوب
الخيارات المتاحة:
accounts,
balances,
transactions
sync
object
مطلوب
history_coverage
object
مطلوب

ما الذي قدّمه البنك من السجل الذي طلبته.

آخر تعديل في ٢٢ نوفمبر ٢٠٢٦