التحقق من الوصول
لضمان إمكانية وصول الأنشطة التجارية التي لديها حالة استخدام مشروعة فقط إلى بيانات الأعمال لدى نشاط تجاري آخر، تجري بعض نقاط نهاية API عملية التحقق من الوصول عندما يتم استدعائها بواسطة تطبيق تم إنشاؤه أو المطالبة به من جانب نشاط تجاري، أو من خلال تطبيق أعمال لم يتم ربطه بنشاط تجاري بعد. وإذا تم اعتماد النشاط التجاري الذي أنشأ التطبيق أو طالب به أو تم ربط التطبيق به كموفر تقني، فستقوم نقاط النهاية بمعالجة الطلب بشكل طبيعي. أما إذا لم يتم اعتماد النشاط التجاري كموفر تقني، فإن نقاط النهاية سترفض الاستدعاء وترجع رسالة خطأ.
التحقق من الوصول هو العملية التي نستخدمها لتحديد ما إذا كان النشاط التجاري يعمل كموفر خدمات تقنية.
ما الأنشطة التجارية التي تخضع لعملية التحقق من الوصول؟
يجب أن يتم اعتماد أي نشاط تجاري قام بإنشاء تطبيق أو المطالبة به، حيث ستستخدمه الأنشطة التجارية الأخرى ويتطلب أيًا من الأذونات المدرجة أدناه، كموفر خدمات تقنية قبل أن يتمكن النشاط التجاري من استخدام التطبيق.
لاحظ أن عملية التحقق من الوصول تتم بشكل مستقل عن مراجعة التطبيقات ومستويات الوصول إلى الأذونات.
الأذونات
إجراء التحقق
عندما يستدعي تطبيق ما تمت المطالبة به بواسطة نشاط تجاري محدد نقطة نهاية تتطلب أيًا من الأذونات المدرجة أعلاه، تتحقق نقطة النهاية أولاً مما إذا كان الشخص الذي منح الإذن لديه دور في التطبيق ذاته. وإذا كان الشخص لديه دور في التطبيق، فإن نقطة النهاية تقبل الاستدعاء وتتابع معالجة الطلب.
مع ذلك، إذا لم يكن للشخص دور في التطبيق، فإن نقطة النهاية تتحقق مما إذا كان قد تم اعتماد النشاط التجاري الذي طالب بالتطبيق كموفر خدمة تقنية. وإذا تم اعتماد النشاط التجاري كموفر خدمة تقنية، فإن نقطة النهاية تعالج الطلب بشكل طبيعي، وبخلاف ذلك، فإنها ترفض الاستدعاء وترجع الخطأ التالي:
- رمز الخطأ:
100 - الوصف:
Unsupported get request. Object with ID{object-id}does not exist, cannot be loaded due to missing permissions, or does not support this operation.
راجع وثائق رموز أخطاء واجهة API التسويق لمزيد من المعلومات حول رموز الخطأ.
لاحظ أنه يتم تنفيذ عملية التحقق على النشاط التجاري الذي طالب بالتطبيق ولكن يتم بدء العملية فقط عندما يستدعي التطبيق الذي قام النشاط التجاري بالمطالبة به نقطة نهاية نفذت إجراء التحقق. وهذا يعني أنه بمجرد اعتماد النشاط التجاري كموفر خدمة تقنية، فإن أي تطبيقات يطالب بها النشاط التجاري ستجتاز إجراء التحقق.
كيفية إكمال عملية التحقق من الوصول
سيتلقى مسؤولو مدير الأعمال، في النشاط التجاري الذي لم يتم اعتماده كموفر خدمة تقنية والذي يطالب تطبيقًا جديدًا، إشعارًا بالبريد الإلكتروني حول متطلبات عملية التحقق من الوصول كلما طلب مسؤول التطبيقالوصول المتقدم لأي من الأذونات المذكورة أعلاه.
سيتضمن البريد الإلكتروني رابطًا لنموذج التحقق، ولكن يمكن أيضًا الوصول إلى النموذج من لوحة معلومات التطبيق بالانتقال إلى الإعدادات الأساسية > عمليات التحقق > لوحة التحقق من الوصول.
لإكمال عملية التحقق، يجب على أي شخص لديه حق وصول كمسؤول في النشاط التجاري تصنيف ووصف كيفية استخدام النشاط التجاري لبيانات الأنشطة التجارية الأخرى لتوفير الخدمات لتلك الأنشطة التجارية.
بمجرد أن يكمل مسؤول مدير الأعمال العملية، سيتم اتخاذ قرار في غضون 5 أيام تقريبًا.
إذا تم اعتماد النشاط التجاري كموفر خدمة تقنية، فسيتلقى مسؤولو مدير الأعمال رسالة تأكيد بالبريد الإلكتروني وسيتلقى مسؤولو التطبيق تنبيه المطوّر للتأكيد. لن تضطر الأنشطة التجارية التي تم "اعتمادها" إلى إجراء عملية التحقق مرة أخرى، ومع ذلك، في ظل ظروف معينة، قد يفقد النشاط التجاري حالة "الاعتماد" مؤقتًا.
إذا رفض النشاط التجاري الخضوع لعملية التحقق لتحديد ما إذا كان يعمل كموفر خدمة تقنية، فسيتلقى مسؤولو مدير الأعمال بريدًا إلكترونيًا بالرفض وسيتلقى مسؤولو التطبيق إشعارًا بالرفض ضمن تنبيهات المطوّرين، وستفشل كل الاستدعاءات التي تتم إلى نقاط النهاية التي تتطلب الأذونات أعلاه إذا لم يكن مستخدم التطبيق لديه دور في تطبيق الذي يُجري الاستدعاء.
إذا تغيرت حالة استخدام الأنشطة التجارية المرفوضة، يجوز لمسؤول مدير الأعمال إكمال العملية مرة أخرى ليتم إعادة النظر فيها.
المتطلبات الأساسية
قبل أن يتمكن مسؤول مدير الأعمال من بدء عملية التحقق من الوصول:
- يجب على مسؤول مدير أعمال إكمال التحقق من النشاط التجاري
- يجب ألا يكون هناك أي تقييدات مفروضة في حساب الأعمال
النشاط التجاري حالي
سيتم إرسال رسالة بريد إلكتروني حول متطلبات التحقق من الوصول تلقائيًا إلى مسؤولي مدير الأعمال الذين طالبوا بالفعل بالتطبيقات التي تستخدمها الأنشطة التجارية الأخرى وتتطلب أيًا من الأذونات المذكورة أعلاه. سيتلقى مسؤولو التطبيق أيضًا تنبيهًا للمطوّر حول هذه المتطلبات.
بمجرد إرسال رسالة البريد الإلكتروني، سيكون أمام مسؤولي مدير الأعمال 60 يومًا لإكمال عملية التحقق. وإذا لم تكتمل العملية في غضون 60 يومًا، فإن كل الاستدعاءات التي تمت في نقاط النهاية التي تتطلب أيًا من الأذونات أعلاه ستخضع تدريجيًا إلى إجراءات التحقق.
فقدان الحالة "تم التحقق منه"
سيتم اعتبار النشاط التجاري الذي تم اعتماده كموفر خدمة تقنية "غير معتمد" في ظل هذه الشروط:
بمجرد معالجة هذه الشروط، سيتم اعتماد النشاط التجاري تلقائيًا كموفر خدمة تقنية من جديد.