--- title: "تغييرات قد تكون مكسورة في واجهة برمجة تطبيقات كاتو وإعلانات نهاية العمر (EoL)" slug: "cato-api-potentially-breaking-changes-and-eol" updated: 2026-11-05T00:10:15Z published: 2026-11-05T00:10:15Z canonical: "knowledge.catonetworks.com/cato-api-potentially-breaking-changes-and-eol" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # تغييرات قد تكون مكسورة في واجهة برمجة تطبيقات كاتو وإعلانات نهاية العمر (EoL) هذه المقالة تمثل منصة للإشعارات حول التغييرات التي قد تكون مكسورة وإعلانات نهاية العمر (EoL) للهيكلية البيانية (GraphQL) الخاصة بواجهة برمجة تطبيقات كاتو وتحتوي على معلومات قد تتطلب منك تحديث عميل واجهة البرمجة. يتم شرح المصطلحات المستخدمة في هذه المقالة في [ما هي واجهة برمجة التطبيقات Cato](/v1/docs/what-is-the-cato-api). لأي عملاء يستخدمون واجهة برمجة API الخاصة بكتو، نوصي بالنقر على **متابعة** لتلقي إشعارات البريد الإلكتروني تلقائيًا للتحديثات المتعلقة بالتغييرات الحرجة على واجهة API. يمكنك أيضًا معرفة المزيد من المعلومات حول واجهات برمجة التطبيقات الجديدة والمحدثة في [سجل تغييرات API لكاتو](/v1/docs/cato-api-changelog). لمزيد من المعلومات حول واجهات برمجة التطبيقات، اطلع على [مرجع API لـGraphQL لشبكات كاتو](https://api.catonetworks.com/documentation/). ## تغييرات قد تؤدي إلى عطل محتمل ### 1-12-2026 - تغييرات API وحدود السرعة بدءًا من 1 ديسمبر 2026، تقوم شركة كاتو تدريجيًا بإدخال بوابة API جديدة تتضمن تغييرات في حدود سرعة API. يتضمن النموذج الجديد: - تحديد السرعة بناءً على النقاط: كل عملية تستهلك نقاطًا بناءً على تكلفتها بدلاً من حساب كل نداء بالتساوي - ميزانية حساب مشتركة: العمليات تسحب النقاط من نفس ميزانية الحساب والتي تتجدد مع مرور الوقت - ميزانيات العمليات الإضافية: بعض العمليات لها ميزانيتها الخاصة بالإضافة إلى ميزانية الحساب المشتركة - إرشادات المحاولات: تشير استجابات API إلى المدة التي يجب انتظارها قبل المحاولة مرة أخرى أو متى يمكن تبسيط أو تقسيم الطلب الذي يتجاوز السعة **هام:** هذا ليس تغييرًا يكسر النظام. لا يوجد تدهور في تكاملاتك الحالية، ولا يلزم اتخاذ أي إجراء. لمزيد من المعلومات، انظر [الأسئلة الشائعة: تغييرات بوابة API القادمة وحدود السرعة](/v1/docs/faq-upcoming-api-gateway-and-rate-limiting-changes) ### 2026-08-30 - تأكيد أكثر صرامة لنوع المخطط ابتداءً من 30 أغسطس 2026، سنفرض تأكيد أكثر صرامة لنوع البيانات عبر واجهة برمجة التطبيقات لتتماشى مع المخطط الموثق. يمكن أن تتأثر المكالمات API التي تمرر قيمة بتنسيق لا يتطابق مع نوع الحقل الموثق، اعتمادًا على نقطة النهاية. - **ما الذي يتغير:** يجب أن تتطابق المعلمات تمامًا مع نوعها المحدد في المخطط. على سبيل المثال، لن تقبل الحقول `Int` سوى القيم الصحيحة — المدخلات النصية مثل `"5"` لن تقبل بعد الآن. هذا ليس محدودًا على الحقول Int فقط — يمكن أن يتأثر أي معلمة تم تمريرها بتنسيق لا يتطابق مع نوعها الموثق. - **ما الذي يجب عليك القيام به قبل 30 أغسطس 2026:** - راجع مكالمات API الخاصة بك للبحث عن القيم التي يتم تمريرها بتنسيق لا يتطابق مع نوع المخطط الموثق (على سبيل المثال، القيم الرقمية التي تمر كنصوص). - قم بتحديث أي مكالمات غير موازية. ### 2026-06-21 - حقول معرف API: تغيير النوع من Long/Integer إلى سلسلة حاليًا، قد يعيد بوابة API الخاصة بـ Cato حقول المعرف كإما سلسلة نصية أو عدد صحيح طويل (integer). كجزء من تحديث البنية التحتية القادمة، سيتم إعادة جميع حقول المعرف بشكل متسق كسلاسل نصية. - **ما الذي يتغير:** استجابات واجهة API التي كانت تعيد سابقًا حقول المعرفات كقيم رقمية طويلة (مثل، `1000000002`) ستعيدها الآن دائمًا كسلاسل (مثل، `"1000000002"`). - **من المتأثر:** عملاء واجهة API الذين يتعاملون مع حقول المعرفات بشكل صارم كأنواع Long/Integer قد يتعرضون للمشاكل عند تنفيذ هذا التغيير. - **ماذا يجب أن تفعل قبل 21 يونيو 2026:** قم بتحديث كود العميل لواجهة API الخاصة بك لقبول كل من أنواع Long وString لحقول المعرفات. سيضمن ذلك انتقالًا سلسًا وتجنب الانقطاعات عندما يدخل التغيير حيز التنفيذ. ### 2025-08-10 - تغيير في حقل البريد الإلكتروني بواجهات API `addAdmin` و `updateAdmin` ففي 10 أغسطس 2025، أصبح حقل `البريد الإلكتروني` في واجهات addAdmin وupdateAdmin API اختياريًا (قابل للتفرغ). يدعم هذا التغيير البنية التحتية القادمة لدعم التحكم الدقيق في الوصول باستخدام واجهات برمجة التطبيقات، والتي تشمل السكريبتات والأتمتة باستخدام المبادئ الخدمية. - يجب على مديري CMA الحاليين والمستقبليين تضمين قيمة `بريد إلكتروني` دائمًا - الاستعلامات التي تُرجع فقط المديرين البشر لا تتأثر. - قد يحتاج بعض العملاء إلى التعامل مع القيم الفارغة في حمولات الرد، مثل addAdminPayload هذا ليس عادةً تغييرًا مكسورًا، لكنه قد يؤثر على العملاء الذين يفترضون أن `email` موجودة دائمًا. راجع تكاملك لتجنب المشاكل. ### 2025-04-27 - واجهة Query {eventsFeed} لدعم جلب الأحداث الأحدث تستخدم واجهة برمجة التطبيقات eventsFeed علامة لتمكين السحب التكراري لتغذية الأحداث. يظهر حقل العلامة معرّفًا يحدد بداية دورة جديدة لجلب الأحداث. تقرأ واجهة برمجة التطبيقات الأحداث من القائمة بناءً على الحقل الفريد للعلامة، وتوفر موقع العلامة التالي في الاستجابة. إذا لم تكن هناك أحداث جديدة في القائمة، فإن حقل العلامة يكون فارغًا. نموذج استهلاك الأحداث البديل هو استخدام التكامل المباشر بدون كود، راجع [دمج أحداث Cato مع AWS S3](/v1/docs/integrating-cato-events-with-aws-s3) و[دمج أحداث Cato مع حساب تخزين {Azure}](%%LINK:13539822366493%%). **ما الذي قمنا بتغييره؟** - سابقًا، عندما لم يتم تحديد العلامة، كانت واجهة برمجة التطبيقات تُرجع أقدم علامة متاحة. كان المطلوب استهلاك قائمة الأحداث كاملة قبل الوصول إلى الأحداث الأكثر حداثة. - اعتبارًا من 27 أبريل، 2025، إذا لم يتم تحديد علامة، فإن واجهة برمجة التطبيقات تُرجع العلامة الأحدث. هذا يسمح لواجهة برمجة التطبيقات بجلب الأحداث الأحدث مباشرة. **هل هو تغيير مؤثر؟** - لا يوجد تأثير لمعظم حالات استخدام واجهة برمجة التطبيقات eventsFeed. لا يوجد تغيير عندما يتم استخدام حقل العلامة للاستعلام، ومنطق استهلاك خلاصة الأحداث هو نفسه. - إذا كان لديك منطق مخصص لاستهلاك القائمة للوصول إلى الأحداث الحديثة، لم يعد هذا المنطق مطلوبًا. - الآن، إذا لم يتم تحديد علامة إدخال، فإن واجهة برمجة التطبيقات تقدم العلامة الأحدث. استدعاء واجهة برمجة التطبيقات بهذه العلامة يجلب الأحداث الأحدث - رد واجهة برمجة التطبيقات يحتوي على علامة تشير إلى الموقع الأحدث (أعلى القائمة) - يجب تحديث البرامج النصية والعمليات الآلية المقابلة ### 2025-02-09 - تعديل بواجهة API {XDR}، limit=0 لم يعد مدعومًا قمنا بتغيير وظيفة حقل `limit` بحيث لم يعد `limit=0` مدعومًا لأنه لا يعتبر من أفضل الممارسات. لضمان استمرار العمل السلس، يجب عليك تحديث أي سكريبتات أو استعلامات تعتمد على هذا المعامل. بدلاً من ذلك، يمكنك تحديد حد بين 1-2000، والذي يدعم بشكل كامل واجهة البرمجة. إذا كنت بحاجة لاسترداد جميع القصص، نوصي باستخدام نهج التصفح الصفحي. ## إعلانات نهاية العمر القادمة ## الإعلانات السابقة لنهاية العمر ### 2026-03-18 - نهاية الحياة لحقل {SecondarySocketSerial} حقل `secondary_socket_serial` في واجهة `EventFieldName` API تم وضع علامة عليه حاليًا كمهمَل وانتهت حياته في 18 مارس 2026. الحقل البديل الموصى به: `socket_serial` ### 2025-06-30 - نهاية الحياة لأنواع {LastMileBwInput} و{InterfaceInfo} و{SocketInterfaceBandwidthInput} حاليًا تم وضع علامة على [الحقول والأنواع](https://api.catonetworks.com/documentation/#definition-LastMileBwInput) التالية في واجهة `LastMileBWInput` API كمهمَلة وانتهت حياتها في 30 يونيو 2025. يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك. | نوع متوقف | نوع موصى به | | --- | --- | | التنزيل | downstreamMbpsPrecision | | التحميل | upstreamMbpsPrecision | حاليًا تم وضع علامة على [الحقول والأنواع](https://api.catonetworks.com/documentation/#definition-InterfaceInfo) التالية في واجهة `InterfaceInfo` API كمهمَلة وانتهت حياتها في 30 يونيو 2025. يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك. | نوع متوقف | نوع موصى به | | --- | --- | | downstreamBandwidth | downstreamBandwidthMbpsPrecision | | upstreamBandwidth | upstreamBandwidthMbpsPrecision | حاليًا تم وضع علامة على [الحقول والأنواع](https://api.catonetworks.com/documentation/#definition-SocketInterfaceWanInput) التالية في واجهة `SocketInterfaceBandwidthInput` API كمهمَلة وانتهت حياتها في 30 يونيو 2025. يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك. | نوع متوقف | نوع موصى به | | --- | --- | | downstreamBandwidth | downstreamBandwidthMbpsPrecision | | upstreamBandwidth | upstreamBandwidthMbpsPrecision | ### 2025-06-08 - نهاية الحياة لحقل {EventFieldName} في {FieldNameInput} - تقبل واجهة برمجة التطبيقات `auditFeed` قائمة من الفلاتر باستخدام النوع `AuditFieldFilterInput`. يتضمن كل فلتر `fieldName` محددًا بالنوع `FieldNameInput`، الذي يتضمن حاليًا حقلي إدخال: `AuditFieldName` و`EventFieldName`. - ومع ذلك، فقط `AuditFieldName` هو حقل إدخال صالح ومدعوم. لتحسين وضوح المخطط وتجنب الالتباس، تم إزالة حقل `EventFieldName` من المخطط في 8 يونيو 2025. - قم بتحديث جميع السكريبتات والاستعلامات التي تستخدم فلاتر `auditFeed` لتستخدم فقط حقل الإدخال `AuditFieldName`. ### 2025-05-01 - نهاية الحياة لأنواع {EventFieldName} حاليًا تم وضع علامة على [الحقول والأنواع](https://api.catonetworks.com/documentation/#definition-EventFieldName) التالية في واجهة `EventFieldName` API كمهمَلة وانتهت حياتها في 1 مايو 2025. يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك. | نوع متوقف | نوع موصى به | | --- | --- | | application | application_id/application_name | | custom_categories | custom_category_id/custom_category_name | | custom_category | custom_category_id/custom_category_name | | الموقع الوجهة | dest_site_id/dest_site_name | | device_posture_profiles | device_posture_profile | | internalId | event_id | | rule | rule_name | | src_site | src_site_id/src_site_name | ### 2025-04-15 - نهاية الحياة لوصف {bgp_peer} تم الإشارة إلى حقل bgp_peer_description في API `EventFieldName` على أنه متوقف وهو نهاية العمر اعتبارًا من 15 أبريل 2025. ### 2025-03-01 - نهاية الحياة لأنواع {EventFieldName} الحقول والأنواع التالية في [EventFieldName](https://api.catonetworks.com/documentation/#definition-EventFieldName) API تم تحديدها بأنها مستغنى عنها وتم إنهاء العمر (EoL) اعتبارًا من 1 مارس 2025. يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك. | نوع متوقف | نوع موصى به | | --- | --- | | parent_pid | src_process_parent_pid | | pid | src_pid | | process_path | src_process_path | ### 2025-02-23 - نهاية الحياة لحقل القيمة {StoryDrillDownFilter} الحقل التالي في [StoryDrillDownFilter](https://api.catonetworks.com/documentation/#definition-StoryDrillDownFilter) Beta API تم تحديده بأنه مستغنى عنه وتم إنهاء العمر (EoL) اعتبارًا من 23 فبراير 2025. يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك. | نوع متوقف | نوع موصى به | | --- | --- | | value | values | ### 2025-02-11 - نهاية الحياة لبعض الأنواع الفرعية لبيانات الأحداث الخاصة بـ {Cato} بعد [الإعلان](/v1/docs/upcoming-eol-for-some-subtypes-of-cato-event-data) عن نهاية الحياة لبعض القيم الفرعية المستخدمة في واجهات API لاستهلاك الأحداث المتعلقة بعملاء {Cato}، تم تعليق الانتشار للحسابات التي تستخدم موقع {Ireland CMA} (cc.catonetworks.com) للحقول التالية: | نوع متوقف | نوع موصى به | | --- | --- | | إعادة الاتصال | متصل أو غير متصل | | PoP تم تغييره | متصل أو غير متصل (يتم إرجاع اسم PoP في حقل lastPopName.) | - لمزيد من المعلومات، راجع [التوجيهات التقنية لـ CMA](/v1/docs/cma-technical-guidelines) ### 2025-01-02 - نهاية الحياة للأنواع الفرعية للأحداث وُضِعَت علامة على الحقول والأنواع المتعلقة بعميل Cato كمهملة وستنتهي في ٢ يناير ٢٠٢٥. يرجى استخدام الحقول والأنواع الموصى بها بدلاً من ذلك. | نوع متوقف | نوع موصى به | الملاحظات | | --- | --- | --- | | VPN عدم التجاوز أبداً | تجاوز دائم | يتم استبدال قيمة النوع الفرعي VPN عدم التجاوز أبدًا بالقيمة تجاوز دائم | | إعادة الاتصال | متصل أو غير متصل | لزيادة التفصيل، يتم تقسيم قيمة النوع الفرعي إعادة الاتصال إلى ٢ قيمتين جديدتين، متصل وغير متصل | | PoP تم تغييره | متصل أو غير متصل (يتم إرجاع اسم PoP في حقل lastPopName) | لزيادة التفصيل، يتم تقسيم قيمة النوع الفرعي تغيير PoP إلى قيمتين جديدتين، متصل وغير متصل | - لمزيد من المعلومات، انظر هذه المقالة: [الإيقاف المتوقع لبعض الأنواع الفرعية لبيانات أحداث Cato](/v1/docs/upcoming-eol-for-some-subtypes-of-cato-event-data)