الانتقال إلى المحتوى الرئيسي
POST
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/: مدخل في الدليل أو عضو في شبكة Didit.

الجسم

application/json
sent_to
string<email>

اختياري. عنوان امتثال مسجل للطرف المقابل: بالنسبة لمدخل الدليل فهو عنوان الامتثال الخاص به أو جهة اتصال يراها تطبيقك، وبالنسبة لعضو في شبكة Didit فهو بريد الامتثال الإلكتروني المؤكد الخاص به. الافتراضي: العنوان الذي يُرسل إليه بريد Travel Rule الإلكتروني إلى الطرف المقابل (جهة الاتصال الخاصة بك أولاً، ثم جهة اتصال المنصة، ثم عنوان الامتثال للمدخل).

الاستجابة

تم إرسال الاستبيان عبر البريد الإلكتروني.

استبيان العناية الواجبة واحد أرسله تطبيقك إلى الطرف المقابل: استبيان Didit القياسي، المُرسل عبر البريد الإلكتروني إلى عنوان الامتثال المسجل مع رابط إجابة للاستخدام مرة واحدة. خاص بتطبيقك.

id
string<uuid>
status
enum<string>

SENT: في انتظار الإجابات. ANSWERED: أجاب الطرف المقابل على كل سؤال. EXPIRED: أُغلق رابط الإجابة دون إجابة (انقضى موعده النهائي، أو حل محله استبيان أحدث)، أو تجاوزت الإجابات تاريخ valid_until.

الخيارات المتاحة:
SENT,
ANSWERED,
EXPIRED
form_version
string

إصدار استبيان Didit القياسي الذي تنتمي إليه الإجابات. حالياً 1.

sent_to
string<email>
sent_at
string<date-time> | null
expires_at
string<date-time> | null

الموعد النهائي للإجابة، 30 يوماً بعد الإرسال. يتوقف الرابط عن العمل بعده.

answered_at
string<date-time> | null
valid_until
string<date-time> | null

المدة التي تظل فيها الإجابات سارية: 365 يوماً بعد الإجابة. تكون null حتى تتم الإجابة.

current
boolean

true طالما أن الاستبيان بحالة ANSWERED ولم يمر تاريخ valid_until.

answers
object

الإجابات مفهرسة بواسطة معرّف السؤال: legal_name، وlicensing، وjurisdictions، وaml_program، وcompliance_officer، وsanctions_screening، وtransaction_monitoring، وtravel_rule، وcustody، وownership، وrecord_keeping، وdata_protection. كل إجابة تصل إلى 2,000 حرف. تكون فارغة حتى يتم الرد.

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