API 3.0 هو إصدار API الافتراضي ونحن نوصي بذلك عند إنشاء عمليات تكامل جديدة تستخدم هذا الإصدار. سنستمر في دعم API 2.0 و 2.1 في المستقبل المنظور ، وسنقدم إشعارًا لمدة 12 شهرًا على الأقل قبل إيقاف تشغيل هذه الإصدارات.
لقد تعلمنا الكثير أثناء الانتقال من API 1.2 إلى API 2. هذه المرة جعلنا عملية الترقية أسهل بكثير. يضيف API 3.0 وظائف جديدة مع تعديل الوظائف الحالية فقط عند الضرورة القصوى. هذا يعني أنه يجب أن يكون المكاملون قادرين على التبديل إلى واجهة برمجة التطبيقات الجديدة بأقل قدر من الجلبة. هذا يعني أيضًا أنه على الرغم من أننا نوصيك بالبدء في التخطيط للترقية في أقرب وقت ممكن حتى تتمكن مؤسستك والباحثون من الاستفادة من الميزات الجديدة ، فلديك قدر كبير من المرونة في تحديد وقت التحديث إلى الإصدار 3.0.
توجد قائمة صغيرة من التغييرات المحتملة في ملاحظات إصدار API الخاصة بنا هنا و هنا. هناك بعض التغييرات حول الحقول الاختيارية / الإلزامية ، وقد تم تعديل تعدادات JSON بشكل طفيف ، ولدينا أيضًا إعادة هيكلة صغيرة لمخططات XML الخاصة بنا ، مع إضافة بعض الحقول الجديدة لاحتواء البيانات الوصفية المطلوبة للوظيفة الجديدة.