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

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

এপিআই স্ক্রিপ্ট এবং কোডিং সম্পর্কিত সমস্যাগুলি সমর্থিত নয়।

প্রয়োজনীয় এপিআই আর্গুমেন্টগুলি

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

• accountMetrics কোয়েরি
  • id - অ্যাকাউন্ট আইডি
  • timeframe - ডেটার সময়কাল যা কুয়েরি ফিরিয়ে দেয়
  • groupDevices - একাধিক সাইটের জন্য এবং একাধিক সকেট সহ সাইটগুলির জন্য, বিশ্লেষণগুলিকে একক সকেটে একত্র করুন (boolean মানের জন্য true)
• accountSnapshot কোয়েরি
  • id - অ্যাকাউন্ট আইডি

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

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

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

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

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

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

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

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

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

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

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

বার্তা: প্রত্যাশিত প্রকার String!, পাওয়া গেছে <number>

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

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

বার্তা: প্রত্যাশিত প্রকার Int!, পাওয়া গেছে \"<number>\

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

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

এপিআই ত্রুটি বার্তা

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

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

আপনার অ্যাকাউন্টের জন্য এপিআই কীতে একটি সমস্যা আছে। প্রস্তাবিত সমাধানগুলি:

• Cato ম্যানেজমেন্ট অ্যাপ্লিকেশন (সিস্টেম > এপিআই অ্যাক্সেস ম্যানেজমেন্ট) এ, নিশ্চিত করুন যে আপনি যে এপিআই কী ব্যবহার করছেন তা এখনও বৈধ। কী বাতিল করা হলে মুছে ফেলা হয়।
• API কোয়েরি সফটওয়্যার এর জন্য HTTP হেডার সেটিংস-এ কীটি সঠিকভাবে কনফিগার করা হয়েছে তা নিশ্চিত করুন: x-api-key <key value>
• যদি সমস্যা বজায় থাকে, একটি নতুন API কী তৈরি করুন এবং এটি API কোয়েরি সফটওয়্যার এ যোগ করুন।

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

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

রক্ষণাবেক্ষণ উইন্ডো চলাকালীন স্ক্রিপ্ট চালানোর সময় সাধারণ API ত্রুটি

রক্ষণাবেক্ষণ উইন্ডো চলাকালীন (সাধারণত প্রতি অন্য রবিবার), কাটো API সার্ভার আপগ্রেড করে এবং এটি অস্থায়ীভাবে দুই মিনিট পর্যন্ত অনুপলব্ধ থাকতে পারে। যদি আপনি পুনরাবৃত্তি এপিআই স্ক্রিপ্ট চালান তবে রক্ষণাবেক্ষণ উইন্ডো চলাকালীন স্ক্রিপ্টটি বিফল হতে পারে এবং একটি ত্রুটি প্রদর্শন করতে পারে। এর মাধ্যমে আপনার অ্যাকাউন্টের ডেটার উপর কোন প্রভাব নেই।

নির্ধারিত রক্ষণাবেক্ষণ উইন্ডো এবং Cato ক্লাউডের স্থিতি সম্পর্কে আপ-টু-ডেট তথ্যের জন্য https://status.catonetworks.com/ দেখুন।

API সার্ভারের সাথে সময়সীমার জন্য সাধারণ API ত্রুটি

যদি API কোয়েরি এর জন্য 40 সেকেন্ডের বেশি বিলম্ব হয় তবে API সার্ভারের সাথে একটি সময়সীমা থাকে এবং আপনাকে কোয়েরি পুনরায় চালাতে হবে। আমরা পরামর্শ দিই যে আপনি আপনার কাটো অ্যাকাউন্টের জন্য একটি API স্ক্রিপ্টের সাথে আবার চেষ্টা করার একটি প্রক্রিয়া অন্তর্ভুক্ত করুন। এই প্রক্রিয়াটি কমপক্ষে দুটি পুনরায় চেষ্টা করার প্রচেষ্টা অন্তর্ভুক্ত করা উচিত এবং প্রতিটি পুনরায় চেষ্টা করার প্রচেষ্টার মধ্যে কমপক্ষে 30 সেকেন্ডের জন্য অপেক্ষা করা উচিত।