مرجع واجهة برمجة تطبيقات بوابة الشركاء السحابيين
ملاحظة
تم دمج واجهات برمجة تطبيقات بوابة الشركاء السحابية مع مركز الشركاء وستستمر في العمل فيها. يقدم الانتقال تغييرات صغيرة. راجع التغييرات التي تطرأ على واجهات برمجة تطبيقات CPP المدرجة في هذا المستند لضمان استمرار عمل التعليمات البرمجية بعد الانتقال إلى مركز الشركاء. يجب استخدام واجهات برمجة تطبيقات CPP فقط للمنتجات الحالية التي تم دمجها بالفعل قبل الانتقال إلى مركز الشركاء؛ يجب أن تستخدم المنتجات الجديدة واجهات برمجة تطبيقات إرسال مركز الشركاء.
تسمح واجهات برمجة تطبيقات REST لبوابة شركاء السحابة بالاسترداد البرنامجي ومعالجة أعباء العمل والعروض وملفات تعريف الناشرين. تستخدم واجهات برمجة التطبيقات التحكم في الوصول المستند إلى دور Azure (Azure RBAC) لفرض الأذونات الصحيحة في وقت المعالجة.
يوفر هذا المرجع التفاصيل الفنية لواجهات برمجة تطبيقات REST لبوابة شركاء السحابة. عينات الحمولة الصافية في هذا المستند هي للرجوع إليها فقط وهي عرضة للتغيير عند إضافة وظائف جديدة.
المتطلبات الأساسية والاعتبارات
قبل استخدام واجهات برمجة التطبيقات، يجب عليك مراجعة:
- مقالة المتطلبات الأساسية لمعرفة كيفية إضافة عنصر أساسي خدمة إلى حسابك، والحصول على رمز وصول Azure Active Directory (Azure AD) للمصادقة.
- تتوفر استراتيجيتا التحكم في التزامن لاستدعاء واجهات برمجة التطبيقات هذه.
- اعتبارات إضافية لواجهة برمجة التطبيقات، مثل تعيين الإصدار ومعالجة الأخطاء.
التغييرات التي تطرأ على واجهات برمجة تطبيقات CPP بعد الترحيل إلى مركز الشركاء
| API | وصف التغيير | التأثير |
|---|---|---|
| نشر Publish، GoLive، Cancel | بالنسبة إلى العروض التي تم ترحيلها، سيكون لرأس الاستجابة تنسيق مختلف ولكنه سيستمر في العمل بنفس الطريقة، ما يدل على مسار نسبي لاسترداد حالة العملية. | عند إرسال أي من طلبات POST المقابلة للحصول على عرض، سيكون لرأس الموقع أحد تنسيقين اعتمادا على حالة ترحيل العرض:
|
| عملية GET | بالنسبة إلى أنواع العروض التي كانت تدعم سابقا حقل "الإشعارات-البريد الإلكتروني" في الاستجابة، سيتم إهمال هذا الحقل ولن يتم إرجاعه بعد الآن للعروض التي تم ترحيلها. | بالنسبة إلى العروض التي تم ترحيلها، لن نرسل بعد الآن إشعارات إلى قائمة رسائل البريد الإلكتروني المحددة في الطلبات. بدلاً من ذلك، سوف تتماشى خدمة API مع عملية الإعلام عبر البريد الإلكتروني في Partner Center لإرسال رسائل البريد الإلكتروني. وعلى وجه التحديد، سيتم إرسال إشعارات إلى عنوان البريد الإلكتروني المحدد في قسم معلومات الاتصال بالبائع في إعدادات حسابك في مركز الشركاء، لإعلامك بتقدم العملية. يرجى مراجعة عنوان البريد الإلكتروني الذي تم تعيينه في قسم معلومات الاتصال بالبائع في إعدادات حسابك في مركز الشركاء لضمان توفير البريد الإلكتروني الصحيح للإشعارات. |
المهام المشتركة
يوضح هذا المرجع تفاصيل واجهات برمجة التطبيقات لتنفيذ المهام الشائعة التالية.