केटो API संभावित रूप से परिवर्तन और अंत-जीवन (EoL)

30 अगस्त, 2026 से, हम प्रलेखित स्कीमा के साथ संरेखित करने के लिए API पर कठोर प्रकार मान्यता लागू कर रहे हैं। एपीआई कॉल जो फ़ील्ड के प्रलेखित प्रकार के साथ मेल नहीं खाते प्रारूप में मान पारित करते हैं, वे प्रभावित हो सकते हैं, यह एंडपॉइंट पर निर्भर करता है।

• क्या बदल रहा है: पैरामीटर को उनकी स्कीमा-परिभाषित प्रकार के साथ मेल खाना चाहिए। उदाहरण के लिए, इंट फ़ील्ड केवल पूर्णांक मान स्वीकार करेंगे — स्ट्रिंग इनपुट जैसे "5" अब स्वीकार नहीं किया जाएगा। यह केवल इंट फ़ील्ड तक सीमित नहीं है — कोई भी पैरामीटर जो प्रलेखित प्रकार के साथ मेल नहीं खाता प्रारूप में पारित होता है, वह प्रभावित हो सकता है।

• आपको 30 अगस्त, 2026 से पहले क्या करना चाहिए:

  • आपकी एपीआई कॉल के लिए उन मूल्यों की समीक्षा करें जो प्रलेखित स्कीमा प्रकार के साथ मेल नहीं खाते प्रारूप में पारित होते हैं (जैसे, स्ट्रिंग के रूप में पारित संख्यात्मक मान)।

  • किसी भी असंगत कॉल को अपडेट करें।

वर्तमान में, Cato का एपीआई गेटवे आईडी फ़ील्ड्स को या तो स्ट्रिंग या लंबा (पूर्णांक) वापस कर सकता है। आगामी संरचना अपडेट के हिस्से के रूप में, सभी आईडी फ़ील्ड्स हमेशा स्ट्रिंग के रूप में वापस किए जाएंगे।

• क्या बदल रहा है: एपीआई प्रतिक्रियाएँ जो पहले आईडी फ़ील्ड्स को एक संख्यात्मक लंबा मान के रूप में वापस करती थीं (उदाहरण के लिए, 1000000002) अब उन्हें हमेशा स्ट्रिंग के रूप में वापस करेगी (उदाहरण के लिए, "1000000002")।

• कौन प्रभावित हो रहा है: API क्लाइंट्स जो आईडी फ़ील्ड्स को केवल लंबे/पूर्णांक प्रकार के रूप में संभालते हैं जब यह परिवर्तन लागू होगा।

• आपको 21 जून, 2026 से पहले क्या करना चाहिए: अपने API क्लाइंट कोड को आईडी फ़ील्ड्स के लिए लंबे और स्ट्रिंग दोनों प्रकारों को स्वीकार करने के लिए अपडेट करें। यह संक्रमण को सुचारू बनाएगा और परिवर्तन के प्रभावी होने पर व्यवधानों को रोकेगा।

10 अगस्त, 2025 को, addAdmin और updateAdmin एपीआई में ईमेल फ़ील्ड वैकल्पिक (nullable) बन गया। इस परिवर्तन से सेवा प्रिंसिपल्स का उपयोग करने वाली स्क्रिप्ट्स और ऑटोमेशन सहित सूक्ष्म API पहुँच नियंत्रण के लिए आगामी इंफ्रास्ट्रक्चर का समर्थन होता है।

• वर्तमान और भविष्य के मानव CMA व्यवस्थापकों को हमेशा एक ईमेल मान शामिल करना चाहिए

• वापसी किए जाने वाले केवल मानव व्यवस्थापक प्रभावित नहीं हैं।

• कुछ क्लाइंट्स को प्रतिक्रिया पेलोड्स में शून्य मानों को संभालने की आवश्यकता हो सकती है, जैसे कि addAdminPayload

यह आमतौर पर एक परिवर्तनशील परिवर्तन नहीं है, लेकिन यह उन क्लाइंट्स को प्रभावित कर सकता है जो मानते हैं कि email हमेशा उपस्थित है। समस्याओं से बचने के लिए अपने एकीकरण की समीक्षा करें।

eventsFeed API घटनाओं फीड को क्रमिक रूप से खींचने में सक्षम बनाने के लिए एक मार्कर का उपयोग करता है। मार्कर फील्ड एक पहचानकर्ता दर्शाता है जो घटनाओं को प्राप्त करने के लिए एक नए पुनरावृत्ति की शुरुआत का संकेत देता है। API मार्कर फील्ड के आधार पर कतार से घटनाओं को पढ़ता है और प्रतिक्रिया में अगले मार्कर स्थान प्रदान करता है। अगर कोई नई घटनाएं कतार में नहीं हैं, तो मार्कर फील्ड खाली होती है।

एक वैकल्पिक घटनाओं की खपत मॉडल सीधे नो-कोड एकीकरण का उपयोग करता है, देखें AWS S3 के साथ Cato Events का एकीकरण और Azure Storage Account के साथ Cato Events का एकीकरण.

हमने क्या बदला?

• पहले, जब मार्कर निर्दिष्ट नहीं होता था, API सबसे पुराना उपलब्ध मार्कर लौटाता था। घटनाओं की सबसे हाल की कतार तक पहुँचने से पहले पूरी घटना कतार को खपत करना आवश्यक था।

• 27 अप्रैल, 2025 से शुरू, यदि कोई मार्कर निर्दिष्ट नहीं किया गया है, तो API सबसे हाल का मार्कर लौटाता है। यह API को सीधे सबसे हाल की घटनाओं को खींचने की अनुमति देता है।

क्या यह परिवर्तनशील परिवर्तन है?

• eventsFeed API के अधिकांश उपयोग मामलों के लिए कोई प्रभाव नहीं है। जब क्वेरी के लिए मार्कर फ़ील्ड का उपयोग किया जाता है, तो कोई परिवर्तन नहीं होता है, और घटनाओं की फ़ीड खपत तर्क समान है।

• अगर आपके पास हाल की घटनाओं तक पहुँचने के लिए कतार को खपत करने की समर्पित लॉजिक है, तो अब इस लॉजिक की आवश्यकता नहीं है।

  • अब, यदि कोई इनपुट मार्कर निर्दिष्ट नहीं किया गया है, तो API सबसे हाल का मार्कर प्रदान करता है। इस मार्कर के साथ API को कॉल करना सबसे हाल की घटनाओं को प्राप्त करता है।

  • API प्रतिक्रिया एक मार्कर होती है जो सबसे हाल के (कतार के शीर्ष) स्थान की ओर इशारा करती है।

  • संबंधित स्क्रिप्ट और स्वत: प्रक्रियाओं को अपडेट किया जाना चाहिए

हमने limit फील्ड की कार्यक्षमता को बदल दिया है ताकि limit=0 अब समर्थित न हो क्योंकि इसे एक अच्छी प्रथा नहीं माना जाता है। सुरक्षित और समर्पित संचालन सुनिश्चित करने के लिए, आपको इस पैरामीटर पर निर्भर स्क्रिप्ट्स या क्वेरियों को अपडेट करना होगा। इसके बजाय, आप 1-2000 के बीच एक सीमा सेट कर सकते हैं, जिसे API पूरी तरह से समर्थित करता है।

अगर आपको सभी कहानियों को प्राप्त करने की आवश्यकता है, तो हम पृष्ठांकन दृष्टिकोण का उपयोग करने की अनुशंसा करते हैं।

EventFieldName एपीआई में secondary_socket_serial घटना फ़ील्ड वर्तमान में अप्रचलित के रूप में चिह्नित है और 18 मार्च, 2026 को समाप्ति के जीवन तक पहुँच गई।

अनुशंसित वैकल्पिक फ़ील्ड: socket_serial

LastMileBWInput एपीआई में निम्नलिखित फ़ील्ड्स और प्रकार वर्तमान में अप्रचलित के रूप में चिह्नित हैं और 30 जून, 2025 को समाप्ति के जीवन तक पहुँच गए।

कृपया अनुशंसित क्षेत्रों और प्रकारों का उपयोग करें।

InterfaceInfo एपीआई में निम्नलिखित फ़ील्ड्स और प्रकार वर्तमान में अप्रचलित के रूप में चिह्नित हैं और 30 जून, 2025 को समाप्ति के जीवन तक पहुँच गए।

कृपया अनुशंसित क्षेत्रों और प्रकारों का उपयोग करें।

SocketInterfaceBandwidthInput एपीआई में निम्नलिखित फ़ील्ड्स और प्रकार वर्तमान में अप्रचलित के रूप में चिह्नित हैं और 30 जून, 2025 को समाप्ति के जीवन तक पहुँच गए।

कृपया अनुशंसित क्षेत्रों और प्रकारों का उपयोग करें।

• AuditFieldFilterInput प्रकार का उपयोग करके auditFeed क्वेरी एपीआई एक सूची स्वीकार करता है। प्रत्येक फ़िल्टर में प्रकार FieldNameInput द्वारा परिभाषित fieldName शामिल होता है, जिसमें वर्तमान में दो इनपुट फ़ील्ड शामिल हैं: AuditFieldName और EventFieldName।

• हालांकि, केवल AuditFieldName मान्य और समर्थित इनपुट फ़ील्ड है। स्कीमा स्पष्टता बढ़ाने और भ्रम से बचने के लिए, EventFieldName फ़ील्ड को 8 जून, 2025 को स्कीमा से हटा दिया गया।

• सभी स्क्रिप्ट्स और क्वेरियों को अपडेट करें जो auditFeed फ़िल्टर का उपयोग करते हैं ताकि केवल AuditFieldName इनपुट फील्ड का उपयोग किया जाए।

EventFieldName एपीआई में निम्नलिखित फ़ील्ड्स और प्रकार वर्तमान में अप्रचलित के रूप में चिह्नित हैं और 1 मई, 2025 को समाप्ति के जीवन तक पहुँच गए।

कृपया अनुशंसित क्षेत्रों और प्रकारों का उपयोग करें।

EventFieldName API में bgp_peer_description फ़ील्ड को हटाया गया और April 15, 2025 को अंत-जीवन (EoL) चिह्नित किया गया।

EventFieldName API में निम्नलिखित फ़ील्ड और प्रकार अप्रचलित के रूप में चिह्नित किए गए थे और 1 मार्च, 2025 से जीवन के अंत (EoL) हैं।

कृपया अनुशंसित क्षेत्रों और प्रकारों का उपयोग करें।

StoryDrillDownFilter बीटा API में निम्नलिखित फ़ील्ड अप्रचलित के रूप में चिह्नित किया गया था और 23 फरवरी, 2025 से जीवन के अंत (EoL) है।

कृपया अनुशंसित क्षेत्रों और प्रकारों का उपयोग करें।

Cato क्लाइंट्स से संबंधित कार्यक्रम उपभोग API में प्रयुक्त कुछ उपप्रकार मानों के EoL की घोषणा के बाद, आयरलैंड CMA स्थान (cc.catonetworks.com) का उपयोग करने वाले खातों के लिए रोलआउट निम्नलिखित फ़ील्ड्स पर रोक दिया जाता है:

• अधिक जानकारी के लिए देखें CMA - Technical Guidelines

Cato क्लाइंट से संबंधित निम्न क्षेत्रों और प्रकारों को अप्रचलित के रूप में चिह्नित किया गया है और 2 जनवरी, 2025 से लाइफ के अंत (EoL) के रूप में चिह्नित किया गया है।

कृपया अनुशंसित क्षेत्रों और प्रकारों का उपयोग करें।

• अधिक जानकारी के लिए, इस लेख को देखें: केटो इवेंट डेटा के कुछ उपप्रकारों के लिए आगामी ईओएल