কাটো এপিআই কলগুলির সমস্যা সমাধান

এই প্রবন্ধটি Cato ব্যবহার করে API টুলস এবং সফটওয়্যার সহ API কোয়েরি চালানোর সময় যে সাধারণ ত্রুটিগুলি ঘটতে পারে তাদের জন্য সমাধান প্রস্তাবনা প্রদান করে। উদাহরণস্বরূপ, Altair এবং Postman।

API স্ক্রিপ্ট এবং কোডিং সম্পর্কিত সমস্যা সমর্থিত নয়।

প্রয়োজনীয় API আর্গুমেন্টস

এই আর্গুমেন্টগুলি API কোয়েরিতে অবশ্যই অন্তর্ভুক্ত করতে হবে। যখন আপনি API কোয়েরি থেকে একটি ঐচ্ছিক আর্গুমেন্ট সরান, ডিফল্ট মান ব্যবহার করা হয়।

  • accountMetrics কোয়েরি

    • id - অ্যাকাউন্ট আইডি

    • timeframe - কোয়েরি যে ডেটার সময়কাল ফেরত দেয়

    • groupDevices - একাধিক সাইট এবং একাধিক সকেট সহ সাইটগুলির জন্য, বিশ্লেষণকে একটি সকেটে সংযুক্ত করুন (বুলিয়ান মান হলে true)

  • accountSnapshot কোয়েরি

    • id - অ্যাকাউন্ট আইডি

সাধারণ GRAPHQL_PARSE_FAILED ত্রুটি

এই অংশটি Cato GraphQL স্কিমার সাথে সম্পর্কিত ত্রুটির বার্তাগুলির কিছু সাধারণ উদাহরণ ব্যাখ্যা করে।

বার্তা: অপ্রত্যাশিত )

কোয়েরিতে অতিরিক্ত বন্ধনী রয়েছে। প্রায়শই এই ত্রুটি ঘটে যখন আপনি একটি আর্গুমেন্টের জন্য বুলিয়ান মান প্রদান করেন না। উদাহরণস্বরূপ, groupInterfaces: , এর পরিবর্তে groupInterfaces: true,

বার্তা: নাম প্রত্যাশিত, পাওয়া গেছে

JSON ফাইলটি সঠিকভাবে ফরম্যাট করা হয়নি। বার্তাটি একটি অক্ষর দেখায় যা অনুপস্থিত বা অতিরিক্ত অক্ষরের সাথে সম্পর্কিত। উদাহরণস্বরূপ, নাম প্রত্যাশিত, ( পাওয়া গেছে আর্গুমেন্টের জন্য accountSnapshot((id: 42). এই আর্গুমেন্টের জন্য সঠিক ফরম্যাট হলো accountSnapshot(id: 1941)

বার্তা: নাম প্রত্যাশিত, পাওয়া গেছে

ত্রুটির বার্তাটি নির্দেশ করে যে একটি আর্গুমেন্টে একটি অবৈধ মান রয়েছে।

উদাহরণস্বরূপ, timeFrame আর্গুমেন্টটি (accountMetrics) কাটো API-তে ISO 8601 তারিখ এবং সময় মানের জন্য উদ্ধরণ চিহ্ন ব্যবহার করে, timeFrame: "last.P1D" সঠিক এবং timeFrame: last.P1D এই ত্রুটি ঘটায়।

সাধারণ GRAPH_QL_VALIDATION_FAILED ত্রুটি

এই অংশটি কোয়েরির আর্গুমেন্টের ভুল ফরম্যাটের সাথে সম্পর্কিত ত্রুটির বার্তাগুলির কিছু সাধারণ উদাহরণ ব্যাখ্যা করে।

বার্তা: টাইপ প্রত্যাশিত, পাওয়া গেছে

ত্রুটির বার্তাটি নির্দেশ করে যে একটি আর্গুমেন্ট একটি অবৈধ মান ধারণ করছে, সাধারণত আর্গুমেন্ট ফরম্যাটের সাথে সম্পর্কিত।

উদাহরণস্বরূপ, সাইট আইডিগুলি আর্গুমেন্টটি (accountMetrics > sites) একটি STRING, তাই আপনাকে মানের জন্য উদ্ধরণ চিহ্ন ব্যবহার করতে হবে, ids: ["4242"] সঠিক এবং ids:[4242] এই ত্রুটি ঘটায়।

বার্তা: টাইপ প্রত্যাশিত, পাওয়া গেছে

ত্রুটির বার্তাটি নির্দেশ করে যে একটি আর্গুমেন্ট একটি অবৈধ মান ধারণ করছে, সাধারণত আর্গুমেন্ট ফরম্যাটের সাথে সম্পর্কিত।

উদাহরণস্বরূপ, সাইট আইডিগুলি আর্গুমেন্টটি (accountSnapshot > sites) একটি INT, তাই আপনাকে মানের জন্য উদ্ধরণ চিহ্ন ব্যবহার করতে হবে না, ids: [2626] সঠিক এবং ids:["2626"] এই ত্রুটি ঘটায়।

API ত্রুটির বার্তাগুলি

এই অংশটি সাধারণ ত্রুটির বার্তাগুলি ব্যাখ্যা করে যা Cato GraphQL স্কিমা বা ফরম্যাটের সাথে বিশেষভাবে সম্পর্কিত নয়।

বার্তা: প্রমাণীকরণ ত্রুটি বা 403

আপনার অ্যাকাউন্টের জন্য API কীতে সমস্যা রয়েছে। প্রস্তাবিত সমাধানসমূহ:

  • Cato Management অ্যাপ্লিকেশনে (System > API Access Management), নিশ্চিত করুন যে:

    • আপনি যে API কী ব্যবহার করছেন তা এখনও বৈধ (স্থিত আছে এবং মেয়াদ উত্তীর্ণ হয়নি)

    • যদি IP ঠিকানা থেকে প্রবেশের অনুমতি দিতে পারেন বিকল্প সেট করা হয়, API ক্লায়েন্ট একটি নির্দিষ্ট অনুমোদিত IP ঠিকানা বা রেঞ্জ থেকে কল করছে

  • HTTP হেডার সেটিংসের জন্য API কোয়েরি সফ্টওয়্যারে কীটি সঠিকভাবে কনফিগার করা আছে তা নিশ্চিত করুন: x-api-key: <key value>, উদাহরণস্বরূপ, x-api-key: abcdef12345

  • যদি সমস্যাটি অব্যাহত থাকে, একটি নতুন API কী তৈরি করুন এবং এটি API কোয়েরি সফ্টওয়্যারে যুক্ত করুন

এটি API ক্লায়েন্টের জন্য বৈধ HTTP হেডারের একটি উদাহরণ:

POST /api/v1/graphql2 HTTP/2
Host: api.catonetworks.com
User-Agent: curl/8.7.1
Accept: */*
Content-Type:application/json
x-api-key: abcdef123456789

বার্তা: একাধিক সাইট নির্বাচন করা হলে ডিভাইস আলাদা করা যাবে না (groupDevices = false)

কোয়েরিতে একাধিক সাইট অন্তর্ভুক্ত করলে groupDevices আর্গুমেন্টের (accountMetrics) মান অবশ্যই true হতে হবে।

এপিআই বিশ্লেষণ ডেটা রূপান্তর

কাটো এপিআই বাইটসে ট্রাফিক তথ্য ফেরত দেয়। ডেটাকে বড় ইউনিটে (যেমন এমবি বা জিবি) রূপান্তর করতে, আপনাকে 1024 এর সূচক মান দ্বারা ভাগ করতে হবে: এমবির জন্য 10242, এবং জিবির জন্য 10243।

উদাহরণস্বরূপ, 536,870,912,000 বাইটকে GB এ রূপান্তর করতে, 10243 দ্বারা ভাগ করে 500GB ডেটা প্রদর্শন করা হবে।

Was this article helpful?

1 out of 1 found this helpful

0 comments