Cato API-এর প্রযুক্তি সঙ্গীদের জন্য রেফারেন্স

কাটো API-এর পরিচিতি

Cato API হল Cato SASE প্ল্যাটফর্মের ডেটা এবং ব্যবস্থাপনা কার্যক্রমের সাথে সম্পর্কিত প্রধান অটোমেশন ইন্টারফেস। এটি GraphQL ব্যবহার করে নিখুঁত প্রশ্ন এবং কার্যকর ডেটা পুনরুদ্ধার সক্ষম করে উভয়েই:

পঠনমাত্র কার্যক্রম (ডেটা এক্সট্রাকশন)
মিউটেশন কার্যক্রম (কনফিগারেশন পরিবর্তন)

বিস্তারিত স্কিম রেফারেন্সের জন্য, Cato API ডকুমেন্টেশন দেখুন: https://api.catonetworks.com/documentation/

API এন্ডপয়েন্ট হল এই ফর্ম্যাটে: https://api.catonetworks.com/api/v1/graphql2

API লাইফসাইকেল

API জীবনচক্র এবং ব্যবহার নির্দেশিকা সম্পর্কে সম্পূর্ণ সংক্ষেপণের জন্য দেখুন What is the Cato API.

কাটো API কী কিভাবে ব্যবহার করবেন

কাটো এপিআইতে অনুরোধগুলি প্রমাণীকরণ করার জন্য, আপনার API ক্লায়েন্টের মধ্যে একটি HTTP হেডার x-api-key অন্তর্ভুক্ত করুন। এই হেডারের মানকে আপনার কাটো API কীতে নিম্নলিখিত বিন্যাসে সেট করুন: x-api-key: <api-key>. উদাহরণস্বরূপ: x-api-key: abcdef12345. এই হেডারটি আপনার অনুরোধকে অনুমোদন করে এবং আপনার কী সঙ্গে সংশ্লিষ্ট অনুমতি ভিত্তিতে প্রাসঙ্গিক কাটো API এন্ডপয়েন্টগুলির অ্যাক্সেস প্রদান করে।

API কী এবং একটি স্যান্ডবক্স পরিবেশ ইন্টিগ্রেশন পরিসর দলিলের Cato এর অনুমোদনের পরে প্রদান করা হবে.

স্কিম পরিবর্তনসমূহ

সম্ভাব্য ব্রেকিং পরিবর্তনগুলির জন্য Cato এর SLA কে Announcing and Managing Potentially Breaking Changes অংশে এবং What is the Cato API প্রবন্ধে নথিভুক্ত করা হয়েছে.

API এবং ক্ষেত্রগুলিকে চিন্হিত করা হয়েছে যেগুলি শেষের দিকে যাচ্ছে (EoL) অপ্রচলিত বলে API ডকুমেন্টেশনে চিহ্নিত করা হয়েছে. যেখানে উপলব্ধ, সুপারিশকৃত প্রতিস্থাপন এবং নির্ধারিত EoL তারিখ প্রদান করা হয়েছে.

এছাড়াও, সম্ভাব্য ব্রেকিং পরিবর্তনগুলি Cato API Potentially Breaking Changes and EoL প্রবন্ধে যোগাযোগ করা হয়. প্রযুক্তি সঙ্গীদেরকে এই প্রবন্ধ অনুসরণ করতে খুব উত্সাহ দেওয়া হয় যাতে আসন্ন স্কিম আপডেট এবং অপ্রচলনের ঘোষণা পাওয়া যায়.

হার সীমাবদ্ধতা এবং ন্যায় ব্যবহার

হার সীমাবদ্ধতা নীতি প্রতি অ্যাকাউন্টের জন্য অনুমোদিত সর্বাধিক অনুরোধ গতি সংজ্ঞায়িত করে এবং প্ল্যাটফর্ম স্থিতিশীলতা এবং ন্যায্য সম্পদ ব্যবহারের নিশ্চয়তা দেওয়ার জন্য ডিজাইন করা হয়েছে. ইন্টিগ্রেশনগুলি হার সীমাবদ্ধ প্রতিক্রিয়া পরিচালনা করার জন্য উপযুক্ত পুনরায় চেষ্টা এবং ব্যাকঅফ প্রক্রিয়াগুলি বাস্তবায়ন করা উচিত. বিস্তারিত জানার জন্য Understanding Cato API Rate Limiting প্রবন্ধে দেখুন.

ইন্টিগ্রেশনের জন্য কোর API এন্ডপয়েন্ট

নিচে প্রাথমিক ইন্টিগ্রেশন এবং ডেটা ইনজেশন সময় ব্যবহৃত সর্বাধিক সাধারণ APIs দেওয়া হল:

ডেটা ধরন	API	উদ্দেশ্য	ঐতিহ্যগত ব্যবহার-কেসগুলি
অপরিশোধন ইভেন্ট / নিরাপত্তা টেলেমেট্রি	eventsFeed	অপরিশোধন ইভেন্ট লগ এবং নিরাপত্তা টেলেমেট্রি খাওয়ার জন্য সুপারিশকৃত প্রবেশ স্থান.	SIEM ইনজেশন, নিরাপত্তা পর্যবেক্ষণ, অনুসরণ লগিং, হুমকি সনাক্তকরণ.
প্রশাসনিক অডিট লগ	auditFeed	অ্যাডমিন কার্যক্রম এবং কনফিগারেশন পরিবর্তনের জন্য অডিট লগ পুনরুদ্ধার করে.	অনুসরণ অডিটিং, পরিবর্তন ট্র্যাকিং, কর্তৃত্ব পর্যবেক্ষণ.
অ্যাপ্লিকেশন & ফ্লো বিশ্লেষণ	appStats appStatsTimeSeries	প্রবাহ সময় সাপেক্ষে অ্যাপ্লিকেশন ব্যবহারের পরিসংখ্যান এবং পারফরম্যান্স মেট্রিক সরবরাহ করে.	অ্যাপ্লিকেশন মনিটরিং, নেটওয়ার্ক পারফরম্যান্স বিশ্লেষণ, ব্যবহার রিপোর্টিং.
নিরাপত্তা ঘটনা / সতর্কতা	গল্পগুলি	উচ্চ-স্তরের অন্তর্দৃষ্টি নিরাপত্তা ঘটনা এবং সম্পর্কিত সতর্কতার মধ্যে.	SOC কাজের প্রবাহ, ঘটনা ব্যবস্থাপনা, সতর্কতা সমৃদ্ধকরণ.
ট্র্যাফিক মেট্রিক্স	accountMetrics	সাইট এবং দূরবর্তী ব্যবহারকারীদের জুড়ে ট্রাফিক এবং ব্যবহারের মেট্রিক্স.	নেটওয়ার্ক ব্যবহার বিশ্লেষণ, ক্ষমতার পরিকল্পনা এবং রিপোর্টিং ড্যাশবোর্ড.
সংযোগ ক্ষমতা & ইনভেন্টরি স্ন্যাপশট	accountSnapshot	সাইট, সকেট, এবং ব্যবহারকারীদের জন্য সংযোগের অবস্থা এবং ইনভেন্টরি তথ্য.	অবকাঠামো মনিটরিং, টপোলজি দৃশ্যমানতা এবং পরিবেশ আবিষ্কার.
ডিভাইস ইনভেন্টরি & গুণাবলী	devices.attributesCatalog devices.list	প্ল্যাটফরম দ্বারা আবিষ্কৃত ডিভাইস ইনভেন্টরি এবং সংশ্লিষ্ট গুণাবলী সরবরাহ করে.	সম্পদ ব্যবস্থাপনা সিস্টেম, আইওটি/ওটি দৃশ্যমানতা, ডিভাইস শ্রেণীকরণ এবং ইনভেন্টরি ট্র্যাকিং.
সকেট পোর্ট মেট্রিক্স	socketPortMetrics socketPortMetricsTimeSeries	সকেট ইন্টারফেস এবং পোর্টগুলির জন্য বর্তমান এবং ঐতিহাসিক মেট্রিক্স সরবরাহ করে.	অবকাঠামো মনিটরিং, লিঙ্ক স্বাস্থ্য পর্যবেক্ষণ, ক্ষমতার পরিকল্পনা এবং নেটওয়ার্ক সমস্যার সমাধান.

সম্পূর্ণ API অপারেশন সংজ্ঞা এবং নমুনা প্রতিক্রিয়াগুলির জন্য দেখুন: Cato GraphQL API Reference.

রেফারেন্স টুল এবং উদাহরণ

ডেভেলপমেন্ট এবং ইন্টিগ্রেশন কাজের প্রবাহকে সমর্থন করার জন্য, কাটো বেশ কয়েকটি রেফারেন্স সম্পদ প্রদান করে:

Cato GitHub Account - নমুনা কোড, API সহায়ক টুল, Jupyter নোটবুক, Postman সংগ্রহ এবং CLI ইউটিলিটিস. উদাহরণসমূহ:
data-analytics - Jupyter নোটবুক যা eventsFeed ব্যবহার-কেস প্রদর্শন করে.
cato-toolbox - API খাওয়া এবং পরীক্ষার জন্য সাধারণ-উদ্দেশ্যের সহকারী, ইভেন্ট ফেচ করার জন্য পায়থন কোডসহ.
GraphQL Playground - API প্রশ্নগুলি পরীক্ষার জন্য ব্রাউজার-ভিত্তিক ইন্টারেক্টিভ টুল. বিস্তারিত জানার জন্য দেখুন: Cato API from the GraphQL Playground.
Cato Remote MCP সার্ভার - AI সহকারী এবং LLM-ভিত্তিক টুলের মাধ্যমে Model Context প্রোটোকল (MCP) ব্যবহার করে কাটো API এর সাথে ইন্টেগ্রেশন সক্ষম করে. এর ফলে প্রাকৃতিক ভাষা বা AI-চালিত কাজের প্রবাহ ব্যবহার করে কাটো ডেটার সাথে যোগাযোগ করার অনুমতি দেয়. আরও তথ্যের জন্য দেখুন: Working with the Cato Remote MCP Server.

সমর্থন এবং কমিউনিটি সম্পদ

পার্টনাররা API সম্পর্কিত প্রশ্ন উত্থাপন করতে পারেন