تغييرات قد تكون مكسورة في واجهة برمجة تطبيقات كاتو وإعلانات نهاية العمر (EoL)

حاليًا، قد يعيد بوابة API الخاصة بـ Cato حقول المعرف كإما سلسلة نصية أو عدد صحيح طويل (integer). كجزء من تحديث البنية التحتية القادمة، سيتم إعادة جميع حقول المعرف بشكل متسق كسلاسل نصية.

• ما الذي يتغير: استجابات واجهة API التي كانت تعيد سابقًا حقول المعرفات كقيم رقمية طويلة (مثل، 1000000002) ستعيدها الآن دائمًا كسلاسل (مثل، "1000000002").

• من المتأثر: عملاء واجهة API الذين يتعاملون مع حقول المعرفات بشكل صارم كأنواع Long/Integer قد يتعرضون للمشاكل عند تنفيذ هذا التغيير.

• ماذا يجب أن تفعل قبل 21 يونيو 2026: قم بتحديث كود العميل لواجهة API الخاصة بك لقبول كل من أنواع Long وString لحقول المعرفات. سيضمن ذلك انتقالًا سلسًا وتجنب الانقطاعات عندما يدخل التغيير حيز التنفيذ.

ففي 10 أغسطس 2025، أصبح حقل البريد الإلكتروني في واجهات addAdmin وupdateAdmin API اختياريًا (قابل للتفرغ). يدعم هذا التغيير البنية التحتية القادمة لدعم التحكم الدقيق في الوصول باستخدام واجهات برمجة التطبيقات، والتي تشمل السكريبتات والأتمتة باستخدام المبادئ الخدمية.

• يجب على مديري CMA الحاليين والمستقبليين تضمين قيمة بريد إلكتروني دائمًا

• الاستعلامات التي تُرجع فقط المديرين البشر لا تتأثر.

• قد يحتاج بعض العملاء إلى التعامل مع القيم الفارغة في حمولات الرد، مثل addAdminPayload

هذا ليس عادةً تغييرًا مكسورًا، لكنه قد يؤثر على العملاء الذين يفترضون أن email موجودة دائمًا. راجع تكاملك لتجنب المشاكل.

تستخدم واجهة برمجة التطبيقات eventsFeed علامة لتمكين السحب التكراري لتغذية الأحداث. يظهر حقل العلامة معرّفًا يحدد بداية دورة جديدة لجلب الأحداث. تقرأ واجهة برمجة التطبيقات الأحداث من القائمة بناءً على الحقل الفريد للعلامة، وتوفر موقع العلامة التالي في الاستجابة. إذا لم تكن هناك أحداث جديدة في القائمة، فإن حقل العلامة يكون فارغًا.

نموذج استهلاك الأحداث البديل هو استخدام التكامل المباشر بدون كود، راجع دمج أحداث Cato مع AWS S3 ودمج أحداث Cato مع حساب تخزين {Azure}.

ما الذي قمنا بتغييره؟

• سابقًا، عندما لم يتم تحديد العلامة، كانت واجهة برمجة التطبيقات تُرجع أقدم علامة متاحة. كان المطلوب استهلاك قائمة الأحداث كاملة قبل الوصول إلى الأحداث الأكثر حداثة.

• اعتبارًا من 27 أبريل، 2025، إذا لم يتم تحديد علامة، فإن واجهة برمجة التطبيقات تُرجع العلامة الأحدث. هذا يسمح لواجهة برمجة التطبيقات بجلب الأحداث الأحدث مباشرة.

هل هو تغيير مؤثر؟

• لا يوجد تأثير لمعظم حالات استخدام واجهة برمجة التطبيقات eventsFeed. لا يوجد تغيير عندما يتم استخدام حقل العلامة للاستعلام، ومنطق استهلاك خلاصة الأحداث هو نفسه.

• إذا كان لديك منطق مخصص لاستهلاك القائمة للوصول إلى الأحداث الحديثة، لم يعد هذا المنطق مطلوبًا.

  • الآن، إذا لم يتم تحديد علامة إدخال، فإن واجهة برمجة التطبيقات تقدم العلامة الأحدث. استدعاء واجهة برمجة التطبيقات بهذه العلامة يجلب الأحداث الأحدث

  • رد واجهة برمجة التطبيقات يحتوي على علامة تشير إلى الموقع الأحدث (أعلى القائمة)

  • يجب تحديث البرامج النصية والعمليات الآلية المقابلة

قمنا بتغيير وظيفة حقل limit بحيث لم يعد limit=0 مدعومًا لأنه لا يعتبر من أفضل الممارسات. لضمان استمرار العمل السلس، يجب عليك تحديث أي سكريبتات أو استعلامات تعتمد على هذا المعامل. بدلاً من ذلك، يمكنك تحديد حد بين 1-2000، والذي يدعم بشكل كامل واجهة البرمجة.

إذا كنت بحاجة لاسترداد جميع القصص، نوصي باستخدام نهج التصفح الصفحي.

حقل secondary_socket_serial في واجهة EventFieldName API تم وضع علامة عليه حاليًا كمهمَل وانتهت حياته في 18 مارس 2026.

الحقل البديل الموصى به: socket_serial

حاليًا تم وضع علامة على الحقول والأنواع التالية في واجهة LastMileBWInput API كمهمَلة وانتهت حياتها في 30 يونيو 2025.

يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.

حاليًا تم وضع علامة على الحقول والأنواع التالية في واجهة InterfaceInfo API كمهمَلة وانتهت حياتها في 30 يونيو 2025.

يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.

حاليًا تم وضع علامة على الحقول والأنواع التالية في واجهة SocketInterfaceBandwidthInput API كمهمَلة وانتهت حياتها في 30 يونيو 2025.

يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.

• تقبل واجهة برمجة التطبيقات auditFeed قائمة من الفلاتر باستخدام النوع AuditFieldFilterInput. يتضمن كل فلتر fieldName محددًا بالنوع FieldNameInput، الذي يتضمن حاليًا حقلي إدخال: AuditFieldName وEventFieldName.

• ومع ذلك، فقط AuditFieldName هو حقل إدخال صالح ومدعوم. لتحسين وضوح المخطط وتجنب الالتباس، تم إزالة حقل EventFieldName من المخطط في 8 يونيو 2025.

• قم بتحديث جميع السكريبتات والاستعلامات التي تستخدم فلاتر auditFeed لتستخدم فقط حقل الإدخال AuditFieldName.

حاليًا تم وضع علامة على الحقول والأنواع التالية في واجهة EventFieldName API كمهمَلة وانتهت حياتها في 1 مايو 2025.

يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.

تم الإشارة إلى حقل bgp_peer_description في API EventFieldName على أنه متوقف وهو نهاية العمر اعتبارًا من 15 أبريل 2025.

الحقول والأنواع التالية في EventFieldName API تم تحديدها بأنها مستغنى عنها وتم إنهاء العمر (EoL) اعتبارًا من 1 مارس 2025.

يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.

الحقل التالي في StoryDrillDownFilter Beta API تم تحديده بأنه مستغنى عنه وتم إنهاء العمر (EoL) اعتبارًا من 23 فبراير 2025.

يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.

بعد الإعلان عن نهاية الحياة لبعض القيم الفرعية المستخدمة في واجهات API لاستهلاك الأحداث المتعلقة بعملاء {Cato}، تم تعليق الانتشار للحسابات التي تستخدم موقع {Ireland CMA} (cc.catonetworks.com) للحقول التالية:

• لمزيد من المعلومات، راجع التوجيهات التقنية لـ CMA

وُضِعَت علامة على الحقول والأنواع المتعلقة بعميل Cato كمهملة وستنتهي في ٢ يناير ٢٠٢٥.

يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك.

• لمزيد من المعلومات، انظر هذه المقالة: الإيقاف المتوقع لبعض الأنواع الفرعية لبيانات أحداث Cato