الانتقال إلى المحتوى الرئيسي
PATCH
cURL
استخدم هذا endpoint لإبقاء كل تطبيق متوافقًا مع العميل أو العلامة التجارية أو البيئة أو حالة الاستخدام الداخلية التي يمثلها. بالنسبة إلى الموزعين، يتيح لك هذا إعادة تسمية كل تطبيق للعميل أو تحديثه دون مشاركة بيانات الاعتماد بين العملاء. أما بالنسبة إلى العملاء المباشرين، فيساعد على فصل المنتجات أو المناطق أو البيئات مع الإبقاء على كل ذلك ضمن مؤسسة واحدة.
يحدّث هذا endpoint البيانات الوصفية للتطبيق فقط. يبقى api_key كما هو ما لم تقم بتدوير بيانات الاعتماد بشكل منفصل.

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

يُختار موقع بيانات التطبيق (data_location) عند إنشاء التطبيق، ولا يمكن تغييره بعد ذلك: التحديث الذي يذكر الموقع الذي يملكه التطبيق بالفعل يُقبل، وأي موقع آخر يُرجع الاستجابة 400. الاستثناء الوحيد هو التطبيق الحي الذي يُنشأ مع مؤسستك، سواء عند التسجيل أو عبر التحقق من البريد الإلكتروني. أول تحديث يذكر data_location يحدد موقعه مرة واحدة فقط، بشرط ألا يكون قد استُخدم أي من مفاتيح API الخاصة بالتطبيق، وألا تكون له أي جلسة تحقق. تستخدم خطوة سمّ تطبيقك الأول في وحدة التحكم هذا الأمر لحفظ الموقع الذي تختاره هناك. الموقع المتاح حاليًا هو eu، أي الاتحاد الأوروبي (أيرلندا).

التفويضات

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"

الجسم

application/json

أرسل فقط الحقول التي تريد تغييرها. دلالات PATCH: يتم الاحتفاظ بالحقول غير المذكورة.

جسم PATCH للبيانات الوصفية للتطبيق. أرسل الحقول التي تريد تغييرها فقط؛ ويتم الاحتفاظ بالحقول التي لم تُذكر. لا يمكن تحديث uuid وclient_id وapi_key. الحقل products للقراءة فقط: يتم تجاهل مفتاح products في الجسم. لا يمكن تغيير data_location بعد إنشاء التطبيق: يُقبل تحديد الموقع الذي يملكه بالفعل، وأي موقع آخر يُرجع 400. الاستثناء الوحيد هو تطبيق الإنتاج المنشأ مع مؤسستك: يحدد التحديث الأول الذي يذكر data_location موقعه، لمرة واحدة، طالما لم يتم استخدام أي مفتاح API للتطبيق ولا توجد له أي جلسة تحقق.

name
string

اسم عرض التطبيق.

مثال:

"Acme Production App"

website_url
string

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

مثال:

"https://app.acme.example"

redirect_uris
string[]

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

مثال:
terms_url
string

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

privacy_url
string

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

description
string

وصف داخلي للتطبيق.

data_location
enum<string>

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

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

"eu"

الاستجابة

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

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