الانتقال إلى المحتوى الرئيسي
GET
curl

التفويضات

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

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

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

vasp_id
string<uuid>
مطلوب

معرّف صف في GET /v3/travel-rule/vasps/.

الاستجابة

الإدخال.

مزود خدمة أصول افتراضية (VASP) في الدليل أو عضو في شبكة Didit، مع المسارات المتاحة لتطبيقك إليه. يُعد العميل عضواً في شبكة Didit فقط طالما أن تطبيقه في بيئة الإنتاج، وTravel Rule مفعّلة لديه، وملفه التعريفي قابل للاكتشاف، ويمتلك اسماً قانونياً وبريداً إلكترونياً مؤكداً للامتثال، ولم تصنف Didit التطبيق على أنه تجريبي أو توضيحي أو داخلي. يحمل كل صف أيضاً تقييم العناية الواجبة المشترك (dd_score وrisk_level وresponsiveness وessential_checks) بالإضافة إلى القرار الخاص بتطبيقك وفحص الكيان والاستبيانات، والتي لا يراها أي عميل آخر.

id
string<uuid>

معرّف الإدخال، لـ GET /v3/travel-rule/vasps/{vasp_id}/.

kind
enum<string>

directory لمُدخل في الدليل المشترك؛ didit لعضو في شبكة Didit.

الخيارات المتاحة:
directory,
didit
name
string
lei
string
jurisdiction
string

رمز الدولة وفقاً لـ ISO 3166، كما يوفره المصدر.

domains
string[]

نطاقات الويب الخاصة بـ VASP. تكون فارغة دائماً لأعضاء شبكة Didit.

reachable
boolean

ما إذا كان تطبيقك يحتوي على مسار متاح إلى هذا VASP، أو إلى أحد كياناته لعلامة تجارية معينة. تكون القيمة دائماً true لعضو شبكة Didit، باستثناء التطبيق في البيئة التجريبية، حيث يكون كل صف false.

aliases
object[]

الأسماء الأخرى التي يُعرَف بها VASP.

networks
object[]
routes
object[]
umbrella
object | null

العلامة التجارية التي يمثل هذا الإدخال كيانًا خاضعًا للتنظيم تابعًا لها. فارغًا عندما لا يكون جزءًا من إحداها.

entities
object[]

بالنسبة للعلامة التجارية، الكيانات الخاضعة للتنظيم التي تتلقى تحويلاتها. التحويل الذي يحدد اسم العلامة التجارية يذهب إلى الكيان الذي يمكن الوصول إليه في الاختصاص القضائي المحدد (beneficiary_data.counterparty_vasp_jurisdiction)، وإلا إلى الكيان الذي ربطه تحليل البلوكتشين بالمحفظة الوجهة، وإلا إلى الكيان الوحيد الذي يمكن الوصول إليه عند عدم تحديد أي اختصاص قضائي. لا يتم التخمين أبداً بين كيانين متطابقين بنفس القدر.

contacts
object[]

جهات اتصال المنصة لهذا الـ VASP وتلك الخاصة بتطبيقك.

dd_status
enum<string>

حالة التحقق من الإدخال لدى Didit، والمحسوبة بواسطة مكوّن التحقق لـ dd_score. تكون دائماً COMPLETED لعضو شبكة Didit.

الخيارات المتاحة:
NOT_STARTED,
IN_PROGRESS,
COMPLETED,
REJECTED
dd_score
integer | null

درجة العناية الواجبة المشتركة لمدخل الدليل، من 0 إلى 100، حيث تعني القيمة الأعلى أماناً أكبر (راجع dd_score_semantic): وهي مجموع النقاط في dd_score_breakdown. تكون قيمتها Null لعضو شبكة Didit، الذي لا يتم احتساب درجات له. يُظهر المدخل الذي لم يتم تقييمه بعد (dd_assessed_at تكون null) القيمة 0 مع حقل risk_level فارغ، لذا يُرجى الاعتماد على risk_level بدلاً من الدرجة الأولية.

النطاق المطلوب: 0 <= x <= 100
reachable_rails
enum<string>[]

شبكات الدفع المسجلة في الإدخال. اقرأ المسارات لمعرفة ما يمكن لتطبيقك استخدامه اليوم.

الخيارات المتاحة:
INTERNAL,
TRP,
GTR,
TRUST,
VERIFYVASP,
SYGNA,
EMAIL
is_didit_customer
boolean

true لعضو في شبكة Didit (يكون dd_status دائماً COMPLETED، وdd_score فارغاً null، وrisk_level فارغاً لهذه الحالات) ولإدخال في الدليل مرتبط بعميل Didit.

dd_score_breakdown
object

كائن واحد لكل مكوّن من dd_score. المكوّنات وأوزانها (الحد الأقصى) ورموز الأسباب الخاصة بها: jurisdiction، 25 (jurisdiction_not_high_risk، jurisdiction_high_risk، jurisdiction_unknown)؛ verification، 15 (dd_status_completed، dd_status_in_progress، dd_status_not_started، dd_status_rejected)؛ protocol، 15 (native_rail، email_only، no_rail)؛ lei، 10 (lei_valid، lei_missing)؛ history، 10 (history، no_history)؛ essentials، 15 (essential_checks، no_essential_checks)؛ responsiveness، 10 (responsive، unresponsive، responsiveness_unknown). يكون فارغاً لعضو في شبكة Didit.

dd_assessed_at
string<date-time> | null

وقت آخر احتساب لـ dd_score وrisk_level وresponsiveness: بعد اكتمال التبادل مع المُدخل، أو إنهائه، أو انتهاء صلاحيته، أو عدم تطابقه، أو رفضه، وعندما تقوم Didit بتحديث المُدخل أو تنقيحه، وأثناء التحديث الأسبوعي للدليل. القيمة Null لعضو في شبكة Didit.

dd_score_semantic
enum<string>

في أي اتجاه تشير dd_score: دائماً higher_is_safer.

الخيارات المتاحة:
higher_is_safer
risk_level
enum<string>

النطاق الذي يقع فيه dd_score: إما LOW (70 أو أكثر)، أو MEDIUM (40 إلى 69)، أو HIGH (أقل من 40). يكون فارغاً لعضو في شبكة Didit ولأي إدخال لم يتم تقييمه بعد. يمكنك التصفية باستخدامه عبر risk. فحصك الذي تم وضع علامة عليه لا يغير أبداً هذه القيمة المشتركة: بل يجعل counterparty_risk_level بقيمة HIGH في قواعدك بدلاً من ذلك.

الخيارات المتاحة:
LOW,
MEDIUM,
HIGH,
responsiveness
object

ما إذا كان مزود VASP يجيب على طلبات Travel Rule: نسبة الطلبات التي بدأها عملاء Didit تجاهه في آخر 90 يوماً وأجاب عليها. تُحتسب فقط الطلبات المرسلة عبر مسار شبكة أو بروتوكول، أو عبر البريد الإلكتروني إلى عنوان مشترك (عنوان الامتثال الخاص بالإدخال أو جهة اتصال المنصة)؛ ولا يُحتسب أبداً الطلب المرسل إلى عنوان كتبه العميل، أو إلى جهة اتصال خاصة بعميل. يُعتبر الطلب منتهي الصلاحية بلا إجابة؛ وتُعتبر عملية التبادل المكتملة أو الرفض أو عدم تطابق البيانات إجابة؛ بينما لا يُعتبر الطلب الملغى أو المسار الذي لا يمكن الوصول إليه أياً منهما. تكون دائماً UNKNOWN مع أعداد صفرية لأي عضو في شبكة Didit.

essential_checks
object

تقرير الفحوصات الأساسية لإدخال الدليل، والذي يتم إنشاؤه حصرياً من المصادر التي تم التحقق منها للمنصة: التسجيل (سجل رسمي يُدرج الـ VASP: سجل MiCA المؤقت للاتحاد الأوروبي، أو دليل TRISA العام، أو سجل LEI العالمي)، والترخيص (تفويض MiCA مسجل وسارٍ)، والنطاق (يطابق نطاق الإدخال نقطة نهاية TRP الخاصة به أو موقع الويب الذي يوفره سجله)، ورمز lei (سجل LEI الخاص به نشط وصادر ومتوافق مع أسماء الإدخال ودولته). يُعد المكوّن الأساسي لـ dd_score هو نسبة الفحوصات المحسومة التي تم اجتيازها بنجاح. يكون فارغاً حتى يتحقق التحديث الأسبوعي للدليل من الإدخال لأول مرة، ودائماً ما يكون فارغاً لأي عضو في شبكة Didit.

decision
object | null

قرار تطبيقك بشأن VASP هذا، أو قرار علامته التجارية بالنسبة لكيان ليس لديه قرار خاص به (يذكر inherited_from اسم العلامة التجارية). يكون null في حال عدم وجود أي قرار. خاص بتطبيقك.

entity_screening
object | null

أحدث فحص للعقوبات والأخبار السلبية أجراه تطبيقك لـ VASP هذا. يكون null عندما لا تفحصه أبداً. خاص بتطبيقك.

questionnaires
object[]

استبيانات العناية الواجبة الخاصة بتطبيقك مع VASP هذا، الأحدث أولاً. خاص بتطبيقك.

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