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

معرّفك الداخلي للمستخدم النهائي الذي يقتصر عليه هذا الـ token. يُفرَض كهوية الموضوع لكل معاملة تُقدَّم باستخدام الـ token.

مثال:

"user-042"

ttl_seconds
integer
افتراضي:900

عمر token بالثواني. القيمة الافتراضية هي 900 (15 دقيقة)؛ والحد الأقصى 86400 (24 ساعة).

النطاق المطلوب: x <= 86400
max_uses
integer | null

الحد الأقصى لعدد عمليات الإرسال الناجحة المسموح بها باستخدام token هذا. احذفه أو استخدم null للاستخدام غير المحدود خلال فترة الصلاحية (TTL).

الاستجابة

الـ token الذي تم إنشاؤه. مرّر sdk_token إلى تطبيقك؛ فهو يُجري المصادقة لـ endpoint الخاصة بـ /v1/transactions/ المواجهة للجهاز عبر رأس X-Transaction-Token حتى expires_at.

sdk_token
string

token المعاملة محدد النطاق لتمريره إلى SDK.

expires_at
string<date-time>

وقت توقف قبول token.

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