الانتقال إلى المحتوى الرئيسي
POST
curl
تتيح واجهة برمجة تطبيقات رابط المستخدم النهائي في Travel Rule من Didit إصدار رابط يُمكّن المستخدم من إكمال اختيار المحفظة أو الطرف المقابل، ويمكن إرساله إلى عنوان بريده الإلكتروني المسجل. أرسل {"channel": "link"} لنسخ رابط، أو {"channel": "email"} لمحاولة إرساله أيضاً عبر البريد الإلكتروني. إذا حذفت channel فالقيمة الافتراضية هي link. يستخدم البريد الإلكتروني العنوان المسجل للمستخدم النهائي في Didit، ولغة جلسة التحقق عند توفرها. لا يمكنك تحديد مستلم عشوائي. تتطلب الواجهة صلاحية الكتابة على المعاملات، وتحويلاً صادراً في حالة AWAITING_COUNTERPARTY أو COUNTERPARTY_VASP_NOT_FOUND أو COUNTERPARTY_VASP_NOT_REACHABLE أو UNCONFIRMED_OWNERSHIP أو ON_HOLD. تُرجع الحالات الأخرى الرمز 409، ويُرجع المعاملة غير المعروفة أو التحويل المفقود الرمز 404. تحتوي الاستجابة على end_user_link وexpires_at وemailed_to وemail_available. يُلغي الرابط الجديد الروابط المفتوحة السابقة للمستخدم النهائي لذلك التحويل. شارك الرابط مع المستخدم النهائي المقصود فقط. عندما لا يوجد بريد إلكتروني مسجل، يُرجع channel: email الرمز 409 مع code: end_user_email_missing؛ اطلب channel: link بدلاً من ذلك. إذا فشل الإرسال، تظل الواجهة تُرجع رابطاً صالحاً للاستخدام مع كون emailed_to فارغًا. تعني email_available وجود عنوان بريد إلكتروني، لا نجاح التسليم. للاطلاع على الاختيار الصريح للمستخدم أثناء الإنشاء، راجع إنشاء معاملة ودليل Travel Rule. للإجراءات على التحويل، راجع تحديث تحويل.

التفويضات

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.

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

transaction_id
string<uuid>
مطلوب

معرّف UUID الثابت للمعاملة من Didit التي تملك التحويل.

الجسم

application/json
channel
enum<string>
افتراضي:link

القيمة link تُرجع رابطًا جديدًا؛ والقيمة email تحاول أيضًا إرساله إلى البريد الإلكتروني المسجّل للمستخدم النهائي في سجل Didit.

الخيارات المتاحة:
link,
email

الاستجابة

استجابة ناجحة.

رابط جديد للمستخدم النهائي. تُلغى الروابط المفتوحة السابقة لهذا التحويل.

expires_at
string<date-time>
مطلوب

انتهاء صلاحية الرابط.

emailed_to
string
مطلوب

المستلم عند نجاح الإرسال، وإلا فسلسلة فارغة. ولا يزال يُرجع رابطاً قابلاً للاستخدام عند فشل البريد الإلكتروني.

email_available
boolean
مطلوب

هل يملك المستخدم النهائي بريداً إلكترونياً في سجله لدى Didit.

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