الانتقال إلى المحتوى الرئيسي
POST
cURL
استخدم نقطة النهاية هذه عندما تحتاج إلى فصل حركة التحقق أو بيانات الاعتماد أو العلامة التجارية أو إعداد التقارير داخل المؤسسة نفسها. وهي مفيدة بشكل خاص لـوكلاء إعادة البيع الذين ينشئون تطبيقاً واحداً لكل عميل. كما أنها تناسب الشركات التي تملك عدة منتجات أو علامات تجارية أو مناطق، أو بيئات اختبار وإنتاج، أو حالات استخدام لا ينبغي أن تشترك في مفتاح API نفسه والإعدادات على مستوى التطبيق.
تستخدم جميع endpoint الخاصة بـ Auth API المسار https://apx.didit.me/auth/v2. استخدم api_key المُعاد كقيمة للرأس x-api-key عند استدعاء endpoint الخاصة بـ https://verification.didit.me/v3/... مثل الجلسات وسير العمل.

موقع البيانات

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

التفويضات

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 للمؤسسة. ابحث عنه باستخدام GET /organizations/me/.

مثال:

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

الجسم

application/json

جميع الحقول اختيارية. يؤدي حذف payload إلى إنشاء تطبيق بالاسم الافتراضي "<organization name> App" وبدون عناوين URL عامة مهيأة.

جميع الحقول اختيارية. يؤدي إرسال payload فارغ إلى إنشاء تطبيق باسم افتراضي في الاتحاد الأوروبي.

name
string

اسم عرض التطبيق. القيمة الافتراضية هي "<organization name> App".

مثال:

"Acme Customer App"

website_url
string

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

مثال:

"https://acme.example"

redirect_uris
string[]

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

مثال:
terms_url
string

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

مثال:

"https://acme.example/terms"

privacy_url
string

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

مثال:

"https://acme.example/privacy"

description
string

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

data_location
enum<string>

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

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

"eu"

الاستجابة

تم إنشاء التطبيق. تتضمن الاستجابة api_key طويل الأجل؛ احفظه الآن واستخدمه كرأس x-api-key في كل استدعاء لـ https://verification.didit.me/v3/....

سجل التطبيق الكامل. لا يتغير كل من 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 في نص إنشاء أو تحديث.

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