--- title: "سجل التغييرات لواجهة برمجة التطبيقات في Cato" slug: "cato-api-changelog" updated: 2026-10-19T23:16:48Z published: 2026-10-19T23:16:48Z canonical: "knowledge.catonetworks.com/cato-api-changelog" --- > ## 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. # سجل التغييرات لواجهة برمجة التطبيقات في Cato هذه المقالة عبارة عن منصة للإشعارات حول التغييرات الأخيرة والمخطط لها في مخطط واجهة برمجة التطبيقات Cato GraphQL. تحتوي على الأخبار والتحديثات التي تبرز الإمكانيات الجديدة، مثل واجهات برمجة التطبيقات التي تم إصدارها حديثًا وأدوات الأتمتة. لمزيد من المعلومات حول التغييرات التي قد تتطلب منك تحديث عميل واجهة برمجة التطبيقات الخاص بك، انظر [تغييرات وأوقات إنتهاء الصلاحية المحتملة لواجهة برمجة التطبيقات Cato](/v1/docs/cato-api-potentially-breaking-changes-and-eol). يتم شرح المصطلحات المستخدمة في هذه المقالة في [ما هي واجهة برمجة التطبيقات Cato](/v1/docs/what-is-the-cato-api). بالنسبة لأي عملاء يستخدمون واجهة برمجة التطبيقات Cato، نحن نوصي بالنقر على **متابعة** لتلقي إشعارات البريد الإلكتروني تلقائيًا بكل التحديثات الخاصة بهذه المقالة المتعلقة بتغييرات واجهة برمجة التطبيقات. للمزيد من المعلومات عن واجهات برمجة التطبيقات، يمكنكم الاطلاع على [مرجع واجهات برمجة التطبيقات GraphQL من Cato Networks](https://api.catonetworks.com/documentation/). ## الأخبار والتحديثات ### تحديث مصادر الاتصال لسياسة الوصول الخاص API - 18 أكتوبر 2026 **تغير:** تحديث API **عنوان الميزة:** توافق مصادر الاتصال لسياسة الوصول الخاص مع واجهات برمجة التطبيقات لجدران الحماية للإنترنت و WAN تقوم واجهة برمجة تطبيقات سياسة الوصول الخاص (الإصدار التجريبي) باستبدال الحقل المهمل `connectionOrigin` (`PrivateAccessPolicyOriginEnum`) بـ `connectionsOriginList` (`ConnectionOriginsEnum`). ينطبق هذا التغيير على `policy.privateAccess.addRule`, `policy.privateAccess.updateRule`, والقواعد التي يتم إرجاعها في استجابات الاستعلام. - `SITE`، `REMOTE_CLIENT`، `REMOTE_EXTENSION`، و `REMOTE_BROWSER` تبقى دون تغيير. الامتدادات وأصول المتصفح تبقى خاضعة لتوافر الحساب. - استخدم قائمة فارغة بدلاً من `ANY` لمطابقة أي مصدر اتصال. - `REMOTE` و `REMOTE_PORTAL` غير مدعومين في الحقل الجديد. - "يتم حاليًا قبول كلا الحقلين ومزامنتهما تلقائيًا، وبالتالي تواصل عمليات الدمج الحالية العمل." "طلبات تحتوي على قيم متضاربة ترجع خطأً" سيتم إزالة الحقل المنتهي صلاحيته والعدد في تغيير مستقبلي. بالنسبة لـ Terraform، فإن `connection_origins` الخاصية وقيمها تبقى دون تغيير. "سيتم نشر ترقية إلى إصدار موفر قبل الإزالة." "بعد الإزالة، لن تدعم إصدارات الموفر القديمة عمليات خطة/تطبيق سياسة الوصول الخاص." تطبيق السياسات غير متأثر. ### إجراءات المستخدم الإضافية **تغير:** تم تحديث API **عنوان الميزة:** إدارة المستخدم المبسطة من خلال سير العمل الخارجي وأنظمة إدارة الهوية ال API يدعم تمكين المستخدمين (`enableUser`) وتعطيل المستخدمين (`disableUser`). ## الأخبار والتحديثات السابقة لواجهة برمجة التطبيقات ### تحسين التحليلات لنتائج API المجمع - ٢١ يونيو ٢٠٢٦ **تغير:** تحديث API **عنوان الميزة:** تحسين التحليلات لنتائج واجهة برمجة التطبيقات AppStats المجمعة والفعاليات عند استعلام بيانات AppStats أو واجهة API للأحداث وتصنيفها حسب بُعد معين، مثل البلد أو نوع الجهاز، يمكنك اختيار عرض السجلات التي لا تحتوي على قيمة لذلك البُعد كمجموعة فارغة. هذا يساهم في ضمان إجماليات متسقة في استعلامات API وإظهار البيانات التي كانت مخفية سابقاً في لوحات التحكم والتقارير لـ CMA. - معامل منطقي جديد على مستوى الاستفسار: `IncludeEmptyDimension`، دون تأثير على البرامج الحالية لواجهة برمجة التطبيقات - ينطبق على استعلامات API والبيانات المعروضة في CMA ### إضافة الحقول لواجهة برمجة التطبيقات appStats لعملاء DEM - ١٩ أبريل ٢٠٢٦ **تغير:** تحديث API **عنوان الميزة:** تحديثات واجهة برمجة التطبيقات appStats لمقاييس تجربة التطبيق الحقول الجديدة التالية لواجهة برمجة التطبيقات appStats متاحة لتمكين الوصول البرمجي إلى بيانات أداء المستخدم والمضيف والتطبيق: - `مستوى_تقييم_التجربة` - مؤشر مستوى تقييم التجربة المجمّع - `ttfb` - الوقت لأول بايت، يقيس استجابة الخادم - `tls_latency` - الوقت لتأسيس الاتصال TLS - `tcp_latency` - وقت إعداد اتصال TCP - `http_latency` - زمن انتقال طلب HTTP من البداية إلى النهاية - `نسبة_خطأ_http` - نسبة الأخطاء المرصودة في HTTP **ملاحظة:** هذه الحقول متاحة فقط للعملاء الذين لديهم ترخيص DEM. ### تمت إضافة واجهات برمجة التطبيقات للطفرات لقوائم البريد والاشتراكات ومجموعات الاشتراكات - ٢٩ مارس ٢٠٢٦ **التغيير:** واجهة برمجة التطبيقات الجديدة **عنوان الميزة:** دعم واجهات برمجية لإدارة نقاط الربط، القوائم البريدية والمجموعات الاشتراكية - استخدم واجهات البرمجة التطبيقية التالية لتعيين، استبدال، تحديث، وإزالة تراخيص المواقع عبر واجهة برمجة التطبيقات للتراخيص الفردية والمجمعة للتفاصيل حول إدارة الإشعارات في CMA، يمكنك الرجوع إلى مقالات قاعدة المعرفة [الإشعارات](/v1/docs/notifications) - - ادارة عمليات الدمج مع الويب باستخدام `createWebhook`، `updateWebhook`، `deleteWebhook`، `webhook`، `webhookList`، و `testWebhook`. - إدارة القوائم البريدية باستخدام `createMailingList`، `updateMailingList`، `deleteMailingList`، `mailingList`، و `mailingListList` - اجمع الويب والقوائم البريدية في مجموعات الاشتراك باستخدام `createSubscriptionGroup`، `updateSubscriptionGroup`، `deleteSubscriptionGroup`، `subscriptionGroup`، و `subscriptionGroupList` ### تحديثات سياسة النفق المتشعب - ١٨ يناير ٢٠٢٦ **تغير:** تحديث API **عنوان الميزة:** تحديثات على Mutations سياسة الشق المقسم - تم تغيير واجهات برمجة التطبيقات التالية لتتماشى بشكل أكثر دقة مع سلوك الميزة في تطبيق إدارة Cato. - **تطبق هذه التغييرات على جميع التغييرات لسياسة الشق المقسم:** - `استبعاد` - تم تغييره إلى RouteAllToCatoExcept - `تضمين` - تم تغييره إلى RouteOnlySelected - `تغطية` - تم تغييره إلى ConnectionMode - `استبعادDns` - تم تغييره إلى dnsSuffix هذه الواجهات البرمجية متوفرة حاليًا كنسخة تجريبية. ### تمت إضافة واجهات برمجة التطبيقات للطفرات لرخص النطاق الترددي للمواقع - 11 أغسطس 2025 **التغيير:** واجهة برمجة التطبيقات الجديدة **عنوان الميزة:** دعم واجهة برمجة التطبيقات لإدارة رخص النطاق الترددي للموقع - استخدم واجهات البرمجة التطبيقية التالية لتعيين، استبدال، تحديث، وإزالة تراخيص المواقع عبر واجهة برمجة التطبيقات للتراخيص الفردية والمجمعة - **واجهات برمجة التطبيقات للطفرات:** - `تعيين ترخيص عرض الموقع` - يعين ترخيصًا للموقع - `تحديث ترخيص عرض الموقع` - للتراخيص المشتركة، تحديث عرض النطاق للموقع - `استبدال ترخيص عرض الموقع` - يستبدل ترخيص الموقع من دون توقف الخدمة - `إزالة ترخيص عرض الموقع` - يزيل الترخيص من الموقع هذه الواجهات البرمجية متوفرة حاليًا كنسخة تجريبية. ### تمت إضافة واجهات برمجة التطبيقات للاستعلام لكتيب التطبيقات وأنواع محتوى DLP - ١٩ مايو ٢٠٢٥ **التغيير:** واجهة برمجة التطبيقات الجديدة **عنوان الميزة:** دعم واجهة برمجة التطبيقات للاستعلام عن فهرس التطبيقات وأنواع محتوى DLP - فهرس التطبيقات - استعلام عن بيانات التطبيقات، بما في ذلك الأنشطة الخاصة بالتوافق، والأمان، وCASB: - `قائمة تطبيقات المكتبة` - جميع التطبيقات والبيانات - `تطبيق المكتبة` - تطبيق واحد - محتوى DLP - استعلام عن أنواع المحتوى للقاعدة الخاصة بحماية البيانات المضمنة لـ DLP - `قائمة مجموعات أنواع المحتوى` هذه الواجهات البرمجية متوفرة حاليًا كنسخة تجريبية. ### إضافة واجهة برمجة التطبيقات للطفرات لـ HA Secondary vSocket - ٢ مارس ٢٠٢٥ **التغيير:** واجهة برمجة التطبيقات الجديدة **عنوان الميزة:** دعم واجهة برمجة التطبيقات لـ vSocket الثانوي لتكوينات HA - استخدم [واجهات البرمجة التالية](https://api.catonetworks.com/documentation/#mutation-sites.addBgpPeer) لوضع أحكام القصص، تغيير الحالة، وإضافة التعليقات - **واجهات برمجة التطبيقات للطفرات:** - `إدخال vSocket الثانوي لـ AWS` لـ vSocket مع تكوين HA، أضف vSocket ثانوي - `إضافة إدخال vSocket الثانوي لـ Azure` لـ vSocket مع تكوين HA، أضف vSocket ثانوي هذه الواجهات البرمجية متوفرة حاليًا كنسخة تجريبية. ### تمت إضافة واجهة برمجة التطبيقات للطفرة XDR - ١٢ يناير ٢٠٢٥ **التغيير:** واجهة برمجة التطبيقات الجديدة **عنوان الميزة:** دعم واجهة برمجة التطبيقات لقصص وتعليقات XDR - استخدم [واجهات البرمجة التالية](https://api.catonetworks.com/documentation/#mutation-xdr.addStoryComment) لوضع أحكام القصص، تغيير الحالة، وإضافة التعليقات - **واجهات برمجة التطبيقات للطفرات:** - `إضافة تعليق على القصة` تعليقات تنشر للمساعدة في تتبع تحقيق القصة - `معلومات نتائج المحلل` إدارة إجراءات القصة، مثل نتائج القصة، النوع، والتصنيف. - `حذف تعليق القصة` احذف تعليقًا منشورًا سابقًا باستخدام معرف التعليق هذه الواجهة لبرمجة التطبيقات متاحة حالياً كنسخة تجريبية. ### دعم عرض النطاق الترددي لمنطقة نهاية التواصل - ١٢ يناير ٢٠٢٥ **التغيير:** تحسين لواجهات برمجة التطبيقات **عنوان الميزة:** تعيين قيم النطاق الترددي للموقع التي تتضمن نقطة عشرية واحدة (مثل 1.5 ميغابت في الثانية) لدقة أكثر تفصيلًا - استخدم [واجهات البرمجة التالية](https://api.catonetworks.com/documentation/#mutation-sites.addSocketSite) لوضع أحكام القصص، تغيير الحالة، وإضافة التعليقات - **الأنواع المتأثرة لواجهات برمجة التطبيقات:** - `مدخل عرض النطاق الأخير` - `مدخل معلومات الواجهة` - `مدخل عرض النطاق الترددي لواجهة المقبس` هذه الأنواع لواجهة برمجة التطبيقات متاحة حاليًا كنسخة تجريبية. ### التغييرات على لقطات الحساب وقياسات الحساب لمواقع IPsec IKEv2 - ١٢ يناير ٢٠٢٥ **التغيير:** تحديث قيمة `Primary` إلى `Primary 1` **عنوان الميزة:** دعم واجهة برمجة التطبيقات لمواقع IPsec IKEv2 القيمة المسترجعة من الحقل `InterfaceId` في استعلامات accountSnapshot و accountMetrics تتغير اعتبارًا من الإصدار التدريجي لدعم التكوينات النشطة/النشطة في 12 يناير 2025. | القيمة القديمة | القيمة الجديدة | ملاحظات | | --- | --- | --- | | أساسي | أساسي1 | يتيح لنا هذا التغيير دعم أكثر من نفق رئيسي واحد | ### واجهة برمجة تطبيقات Peering BGP جديدة - ٢٣ ديسمبر ٢٠٢٤ **التغيير:** واجهة برمجة التطبيقات الجديدة **عنوان الميزة:** دعم واجهة برمجة التطبيقات لـ BGP Peering - استخدم واجهات البرمجة التالية لتبسيط [الإعداد](https://api.catonetworks.com/documentation/#mutation-sites.addBgpPeer) و[المراقبة](https://api.catonetworks.com/documentation/#query-site.bgpPeer) لـ BGP peers للمواقع - **واجهات برمجة التطبيقات للطفرات:** - `إضافة BGP Peer` أضف BGP peer جديداً إلى الموقع - `تحديث BGP Peer` تحديث إعدادات لتكوين BGP peer الحالي - `إزالة BGP Peer` حذف تكوين BGP peer للموقع - **واجهات برمجة التطبيقات للاستعلام:** - `BGP Peer` استرد معلومات حول BGP peer محدد - `حالة BGP الموقع` عرض حالة BGP الحالية، بما في ذلك تفاصيل الجلسة ومعلومات التوجيه هذه الواجهة لبرمجة التطبيقات متاحة حالياً كنسخة تجريبية.