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

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

token
string
مطلوب

token جلسة مبهم يُعاد عند إنشاء جلسة الأداة.

الجسم

application/json
method
enum<string>
مطلوب

طريقة الإثبات التي اختارها المستخدم النهائي. يجب أن تكون إحدى الطرق المسموح بها في allowed_methods ضمن السياق.

الخيارات المتاحة:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
wallet_address
string

القيمة الافتراضية هي wallet_address الخاص بالجلسة. يجب أن يطابق محفظة التحويل عندما تكون الجلسة مرتبطة بتحويل.

Maximum string length: 128
chain
string

القيمة الافتراضية هي سلسلة الكتل الخاصة بالجلسة.

Maximum string length: 32

الاستجابة

تم استئناف الإثبات المفتوح بالفعل لهذه الطريقة.

proof_id
string<uuid>
method
enum<string>
الخيارات المتاحة:
MESSAGE_SIGNING,
SATOSHI_TEST,
SCREENSHOT,
SELF_DECLARATION
status
enum<string>

PENDING: اختار المستخدم النهائي هذه الطريقة ولم يُبت في الإثبات بعد. يؤدي التوقيع الفاشل أو الإيداع التجريبي غير القابل للقراءة أو غير المؤكد بعد إلى إبقاء الإثبات PENDING مع وجود failure_reason، حتى يتمكن المستخدم النهائي من المحاولة مجددًا؛ ويُعاد فحص إيداع SATOSHI_TEST المُرسل تلقائيًا حتى تُغلق نافذته الزمنية، بينما تنتظر لقطة شاشة SCREENSHOT المُرسلة مراجعتك. VERIFIED: تم إثبات الملكية. REJECTED: الإيداع التجريبي غير صحيح فعليًا (مُرسِل آخر، أو ليس المبلغ المتوقع إلى عنوان الإيداع، أو أقدم من التحدي، أو معاملة أثبتت بالفعل محفظة أخرى) أو قام المراجِع برفض لقطة الشاشة؛ ويوضح failure_reason السبب بدقة. الإثبات المرفوض نهائي ويستهلك إحدى محاولات الجلسة. EXPIRED: لم يعد بالإمكان البت في الإثبات (أُغلقت نافذته الزمنية، أو غيّر المستخدم النهائي الطريقة، أو انتهت جلسة الأداة، أو تغيّر حامل المحفظة)؛ ويوضح failure_reason السبب بدقة.

الخيارات المتاحة:
PENDING,
VERIFIED,
REJECTED,
EXPIRED
wallet_address
string
chain
string

معرّف السلسلة القياسي لإدخال دفتر العناوين الذي يخصه الإثبات، على سبيل المثال ETH، BTC، SOL، TRX.

deposit_address
string | null

عنوان الإيداع الذي يجب على العميل إرسال مبلغ اختبار Satoshi إليه. يتوفر فقط في إثبات SATOSHI_TEST.

expected_amount
string | null

المبلغ الدقيق على السلسلة، بالعملة الأصلية للإيداع، الذي يجب أن يتطابق معه إيداع اختبار Satoshi. موجود فقط في إثبات SATOSHI_TEST.

expires_at
string<date-time> | null

الموعد النهائي للنافذة الزمنية لاختبار ساتوشي الخاص بهذا الإثبات. يظهر فقط في إثبات من نوع SATOSHI_TEST؛ ويتم تمديد expires_at الخاص بجلسة عنصر الواجهة لتغطيته عند تقديم SATOSHI_TEST.

challenge
string | null

رسالة صادرة عن Didit يوقّعها العميل بمحفظته. تتوفر فقط في إثبات MESSAGE_SIGNING.

rejection_reason
string

سبب رفض الإثبات، كجملة باللغة الإنجليزية للمستخدم النهائي. يظهر فقط عندما تكون status هي REJECTED؛ ويكون فارغاً عندما يرفض المراجِع لقطة شاشة (تبقى ملاحظتك لديك).

created_at
string<date-time>
attempts
integer

عدد المرات التي تم فيها تقديم أدلة لهذا الإثبات (التوقيعات، معرّفات المعاملات، عمليات الرفع).

failure_reason
enum<string>

سبب عدم نجاح المحاولة الأخيرة، أو سبب إغلاق الإثبات. يكون فارغاً إذا لم يفشل أي شيء.

الخيارات المتاحة:
,
SIGNATURE_INVALID,
SIGNATURE_UNSUPPORTED_SCHEME,
DEPOSIT_NOT_FOUND,
DEPOSIT_UNCONFIRMED,
DEPOSIT_LOOKUP_FAILED,
DEPOSIT_MISMATCH,
DEPOSIT_STALE,
TXID_REUSED,
CHAIN_UNSUPPORTED,
WINDOW_EXPIRED,
OWNERSHIP_CHANGED,
METHOD_SWITCHED,
REVIEW_REJECTED,
ABANDONED
آخر تعديل في ٧ نوفمبر ٢٠٢٦