الانتقال إلى المحتوى الرئيسي
GET
cURL

التفويضات

Authorization
string
header
مطلوب

رمز access_token بصيغة JWT موقّع باستخدام RS256 ومُرجع بواسطة POST /programmatic/login/ أو POST /programmatic/verify-email/. يُرسل كـ Authorization: Bearer <access_token>. مدة الصلاحية الافتراضية هي 86400 ثانية (24 ساعة). هذا الـ token صالح فقط مقابل نقاط endpoint لإدارة الحسابات على apx.didit.me/auth/v2. تستخدم API التحقق (verification.didit.me/v3) الـ api_key طويل الأجل كـ x-api-key بدلاً من ذلك.

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

org_id
string<uuid>
مطلوب

معرّف UUID للمؤسسة التي تملك التطبيق.

مثال:

"a1b2c3d4-5678-90ab-cdef-111111111111"

app_id
string<uuid>
مطلوب

معرّف UUID للتطبيق الذي تريد قراءة بيانات اعتماده.

مثال:

"b2c3d4e5-6789-01bc-defg-222222222222"

الاستجابة

سجل التطبيق متضمناً client_id وapi_key الخاصين به.

سجل التطبيق الكامل. لا يتغير كل من uuid وclient_id وapi_key أبداً بعد الإنشاء. ولا يتغير data_location أيضاً، باستثناء مرة واحدة في التطبيق المباشر المنشأ مع مؤسستك، قبل استخدامه (راجع طلب التحديث).

uuid
string<uuid>

معرّف UUID للتطبيق. يُستخدم كـ {app_id} في الاستدعاءات اللاحقة.

مثال:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

اسم عرض التطبيق الذي يظهر في وحدة تحكم Didit.

مثال:

"Acme Production App"

client_id
string

معرّف عميل عام، آمن للتضمين في مسارات نمط OAuth.

مثال:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

سر طويل الأجل (يُسمى أيضاً client_secret). يُستخدم كترويسة x-api-key لكل استدعاء إلى https://verification.didit.me/v3/... (الجلسات، وسير العمل، وفحص AML، وما إلى ذلك). تعامل معه كبيانات اعتماد؛ ولا تكشفه أبداً من جانب العميل. تبدأ المفاتيح الجديدة بـ sk_live_ (تطبيق الإنتاج) أو sk_test_ (تطبيق البيئة التجريبية)، متبوعة بـ 43 حرفاً آمناً لعنوان URL (أحرف، وأرقام، و -، و _). المفاتيح التي تم إنشاؤها قبل هذا التنسيق لا تحتوي على بادئة وتستمر في العمل دون تغيير. لمدة 72 ساعة بعد استرداد حسابك، تُرجع عمليات الإدراج والاسترداد والتحديث سلسلة فارغة هنا بدلاً من المفتاح.

مثال:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

رابط الموقع الإلكتروني أو التطبيق المرتبط بهذا التطبيق.

مثال:

"https://acme.example"

redirect_uris
string[]

عناوين URI المسموح بإعادة التوجيه إليها لمسارات إعادة توجيه التحقق وتلك الشبيهة بـ OAuth.

مثال:
terms_url
string | null

رابط شروط الخدمة المعروض في مسار التحقق.

مثال:

"https://acme.example/terms"

privacy_url
string | null

رابط سياسة الخصوصية المعروض في مسار التحقق.

مثال:

"https://acme.example/privacy"

description
string | null

وصف داخلي للتطبيق (لا يظهر للمستخدمين النهائيين).

created_at
string<date-time>
مثال:

"2025-06-01T10:00:00Z"

data_location
enum<string>

مكان تخزين ومعالجة بيانات التحقق الخاصة بالتطبيق، ويتم اختياره عند إنشاء التطبيق. القيمة eu هي الاتحاد الأوروبي (أيرلندا)، وهو الخيار الافتراضي. ستتوفر قيمتا au (أستراليا، سيدني) وmx (المكسيك) قريباً: أي طلب يحددهما يُرجع استجابة 400 This data location is not available yet.. يكون تطبيق البيئة التجريبية للمؤسسة دائماً في الاتحاد الأوروبي.

الخيارات المتاحة:
eu,
au,
mx
مثال:

"eu"

products
object[]
read-only

منتجات التطبيق. دائماً جميع المنتجات الثلاثة، بهذا الترتيب: identity، transactions، authentication. يحتوي التطبيق الجديد على identity مفعّلاً مع تشغيل كل وحدة، وtransactions وauthentication معطّلين. للقراءة فقط: يتم تجاهل مفتاح products في نص إنشاء أو تحديث.

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