الانتقال إلى المحتوى الرئيسي
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.

الجسم

application/json
wallet_address
string

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

Maximum string length: 128
chain
string

رمز السلسلة (token) للعنوان، على سبيل المثال ETH أو BTC أو SOL. استخدم نفس الـ token الموجود في دفتر عناوين محفظتك. يتم توفير توقيع الرسائل واختبار Satoshi فقط للسلاسل المدعومة. يخزّن مدخل دفتر العناوين الذي يتحقق منه الإثبات السلسلة تحت معرّفها القياسي (ETH، BTC، SOL، TRX).

Maximum string length: 32
holder_name
string

اسم صاحب المحفظة، يُستخدم لمطابقة اسم المستفيد.

Maximum string length: 255
vendor_data
string

معرّفك الداخلي للحائز، ويُنقَل إلى إدخال دفتر العناوين الذي تم إنشاؤه.

Maximum string length: 255
transaction_id
string<uuid> | null

اختياري. معرّف UUID لمعاملة Didit خاصة بتحويل وفق Travel Rule للمتابعة عند التحقق من الإثبات.

satoshi_deposit_address
string

اختياري. عنوان إيداع تتحكم فيه؛ يؤدي توفيره إلى تمكين طريقة إثبات SATOSHI_TEST.

Maximum string length: 128
callback_url
string

اختياري. رابط http(s) مطلق يُعيد إليه عنصر واجهة المستخدم العميل بعد الاكتمال.

Maximum string length: 512
expires_in_minutes
integer
افتراضي:60

اختياري. مدة صلاحية الرابط المنشأ، بالدقائق. يتم تمديدها تلقائياً لتغطية نافذة اختبار Satoshi عند تقديم SATOSHI_TEST.

النطاق المطلوب: 5 <= x <= 10080

الاستجابة

جلسة الأداة التي تم إنشاؤها حديثاً.

widget_session_id
string<uuid>
token
string

token جلسة مبهم مضمن في عنوان URL للأداة.

url
string

رابط أداة إثبات ملكية المحفظة المستضافة. افتحه كما هو في متصفح النظام (وليس داخل عرض الويب داخل التطبيق في SDK للأجهزة المحمولة مطلقاً).

expires_at
string<date-time>
آخر تعديل في ٧ نوفمبر ٢٠٢٦