إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
تقدم هذه المقالة نظرة عامة حول سياسات تغيير الإصدارات وكسر التغيير لأدوات قابلية البرمجة المختلفة.
معلومات الدعم والإهلاك
عند إصدار إصدار جديد من واجهة برمجة تطبيقات REST، يتم إيقاف الإصدارات السابقة. تعلن Microsoft عن إهمال إصدار قبل 12 شهرا على الأقل من إيقاف نقطة نهاية واجهة برمجة التطبيقات. عند إهمال إصدار، يتم دعمه as-is. إذا واجهت مشكلة في هذا الإصدار، فإننا نطلب منك الانتقال إلى الإصدار المستقر حاليا. عند إيقاف إصدار، فإنه غير مدعوم وسيتم إيقاف تشغيله قريبا.
من خلال زيادة رقم إصدار واجهة برمجة التطبيقات (على سبيل المثال، من 2021-10-01 إلى 2022-04-01)، Microsoft يعلن أن الإصدار السابق المتاح بشكل عام (في هذا المثال، 2021-10-01) قد تم إهماله على الفور وسيتم إيقافه بعد 12 شهرا من الإعلان. Microsoft قد يقدم استثناءات لهذا النهج لمشكلات حماية الخدمة وأمانها.
يتم تحديث الأدوات المختلفة ومجموعات SDK التي يتم إنشاؤها أعلى Power Platform API مثل Power Platform CLI وموصل Admin V2 وPowerShell إلى إصدارات API أحدث على أساس كل إجراء وتكون شفافة للمستخدمين النهائيين.
التغييرات المتوافقة والعاجلة
توفر Microsoft تفاصيل تغييرات قابلية البرمجة في خطط الإصدار. إذا كانت التغييرات غير منكسرة بطبيعتها، فسيظل إصدار واجهة برمجة التطبيقات كما هو، ويتلقى إصدار PowerShell زيادة إصدار ثانوية. إذا كانت التغييرات تتعطل بطبيعتها، فإن Microsoft تقوم بزيادة إصدار واجهة برمجة التطبيقات والإصدار الرئيسي ل PowerShell.
فيما يلي أمثلة على التغييرات العاجلة:
- تم تغيير عنوان URL أو الطلب/الاستجابة الأساسية.
- تتم إزالة الخاصية المُعلنة أو إعادة تسميتها، أو تغيير نوعها.
- تتم إزالة أو إعادة تسمية معلمات API أو API.
- تمت إضافة معلمة الطلب المطلوبة.
فيما يلي أمثلة على التغييرات غير المكسرة:
- يتم إضافة الخصائص التي تكون خالية أو لها قيمة افتراضية.
- يتم إضافة عضو إلى التعداد.
- يتم تقديم الترحيل إلى المجموعات الموجودة.
- تم تغيير رموز الخطأ.
- تم تغيير ترتيب الخصائص في الطلبات أو الردود.
Available versions
| Version | Type | Reference | Deprecation date | Decommission date |
|---|---|---|---|---|
| 2024-10-01 | Stable | Reference | N/A | N/A |
| 2020-10-01 | Generally available | 2020-10-01 Ref | N/A | N/A |
Note
النسخة المتاحة عموما من واجهة Power Platform لعام 2020-10-01 مخصصة لإدارة البيئة وتعرف أيضا باسم واجهة برمجة تطبيقات التطبيقات التجارية (BAP). تتوفر وظائف هذه المجموعة من نقاط النهاية في الإصدارات الأحدث من Power Platform API.
Next steps
الآن بعد أن فهمت إستراتيجية الإصدار والدعم، دعنا نتعرف على كيفية المصادقة باستخدام واجهة API في Microsoft Power Platform.