ব্যবহারকারী এবং হার সীমা

Device Access পরিবেশ এবং বাণিজ্যিক প্রস্তাবের প্রকারের উপর নির্ভর করে প্রকল্পগুলি ব্যবহারকারী, কাঠামো এবং হারের সীমা দ্বারা সীমাবদ্ধ।

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

পরিবেশ দ্বারা সীমাবদ্ধতা

সমস্ত প্রকল্প স্যান্ডবক্স পরিবেশে শুরু হয়। স্যান্ডবক্সটি SDM API এবং ব্যক্তিগত ব্যবহারের মূল্যায়নের উদ্দেশ্যে তৈরি করা হয়েছে এবং সেই অনুযায়ী সীমা সীমাবদ্ধ। বাণিজ্যিক উন্নয়নের মতো বৃহত্তর ব্যবহারকারী বেস সহ পরিবেশের বিভিন্ন সীমা রয়েছে।

স্যান্ডবক্স ব্যবহারকারীর সীমা

স্যান্ডবক্সে একটি বিকাশকারী অ্যাকাউন্ট সমস্ত প্রকল্পের 5টি কাঠামো জুড়ে 25 জন ব্যবহারকারীর মধ্যে সীমাবদ্ধ। প্রতি অ্যাকাউন্টে 3টি প্রকল্পের সীমা রয়েছে।

প্রতিটি স্ট্রাকচার 5 জন ব্যবহারকারীর মধ্যে সীমিত, তাই ব্যবহারকারীর সীমা শুধুমাত্র একবার পৌঁছানো হবে যখন প্রতিটি 5টি স্ট্রাকচার সর্বোচ্চ 5 জন ব্যবহারকারীর সাথে শেষ হয়ে যাবে। বিকাশকারী অ্যাকাউন্ট (যেটি প্রকল্পের মালিক) একটি কাঠামোর জন্য 5 ব্যবহারকারীর সীমার মধ্যে গণনা করে না।

বিপরীতভাবে, যদি একটি প্রকল্পে 5টি কাঠামোর মধ্যে 15 জন ব্যবহারকারী থাকে, তবে অতিরিক্ত ব্যবহারকারী শুধুমাত্র বিদ্যমান 5টি কাঠামোতে যোগ করা যেতে পারে, কারণ কাঠামোর সীমা ইতিমধ্যেই পৌঁছে গেছে।

স্যান্ডবক্স হারের সীমা

স্যান্ডবক্স 3টি ভিন্ন স্তরে সীমাবদ্ধ। সীমা প্রতি মিনিটে (QPM) প্রশ্নে সেট করা হয় যদি না অন্যথায় উল্লেখ করা হয়।

API স্তর

API কল সীমিত প্রকল্প প্রতি, ব্যবহারকারী প্রতি. পৃথক পদ্ধতি সম্পর্কে আরও তথ্যের জন্য API রেফারেন্স দেখুন।

এপিআই পদ্ধতি	হারের সীমা
devices.executeCommand	10 QPM
devices.get	10 QPM
devices.list	5 QPM
structures.get	5 QPM
structures.list	5 QPM
structures.rooms.get	5 QPM
structures.rooms.list	5 QPM

কমান্ড স্তর

প্রতিটি বৈশিষ্ট্য কমান্ড ( devices.executeCommand ) 5 QPM প্রতি প্রকল্প, প্রতি ব্যবহারকারী, ডিভাইস প্রতি সীমাবদ্ধ।

তার মানে যদি একটি প্রকল্পে 2 জন ব্যবহারকারী থাকে যার প্রতিটিতে 2টি ডিভাইস থাকে (মোট 4টি ডিভাইস), একই কমান্ডটি সেই 4টি ডিভাইসের প্রতিটির জন্য এক মিনিটে 5 বার কল করা যেতে পারে।

যাইহোক, যদি একটি প্রকল্পে 6টি মোট ডিভাইসের জন্য 3টি ডিভাইস সহ 2 জন ব্যবহারকারী থাকে, তবে সেই 6টি ডিভাইসের প্রতিটির জন্য একই কমান্ডটি এক মিনিটে 5 বার কল করা যাবে না । এর ফলে প্রতিটি ব্যবহারকারীর জন্য 15 QPM হবে, যখন একটি প্রকল্পের ব্যবহারকারীর জন্য devices.executeCommand API স্তরের হার 10 QPM হয়।

ডিভাইসের উদাহরণ স্তর

অতিরিক্তভাবে, ডিভাইসের ব্যাটারি সুরক্ষার জন্য ডিভাইস ইনস্ট্যান্স লেভেল সীমা প্রকল্প এবং কমান্ড ( devices.executeCommand ) জুড়ে প্রয়োগ করা হয়। এই সীমাগুলি QPM এবং ক্যোয়ারী প্রতি ঘন্টা (QPH) উভয় স্তরেই প্রয়োগ করা হয় এবং এপিআই পদ্ধতিগুলি get এবং list ক্ষেত্রে প্রযোজ্য নয়৷

উদাহরণ স্বরূপ, ধরুন প্রজেক্ট এ এবং প্রজেক্ট বি উভয়েরই একই ডিভাইসে অ্যাক্সেস আছে, ডিভাইস A (সম্ভবত ব্যবহারকারী দুটি ভিন্ন বাণিজ্যিক ইন্টিগ্রেশন অনুমোদন করেছে যা একই ডিভাইস ব্যবহার করে)। যদি প্রজেক্ট A এক মিনিটের মধ্যে ডিভাইস A-তে 4টি কমান্ড পাঠিয়ে থাকে, তাহলে ডিভাইসের ইন্সট্যান্স লেভেল রেট লিমিট হিট হওয়ার আগে প্রজেক্ট B সেই একই মিনিটে ডিভাইস A-তে শুধুমাত্র 1টি কমান্ড পাঠাতে পারে। সেই মুহুর্তে, ডিভাইস A-তে উভয় প্রকল্পের কমান্ডগুলি ডিভাইস A-তে প্রথম কমান্ড দিয়ে শুরু হওয়া মিনিটের শেষ পর্যন্ত থ্রোটল করা হয়।

যদি একটি ডিভাইসের ধরন নীচে তালিকাভুক্ত না থাকে, তবে এটির ডিভাইসের দৃষ্টান্ত স্তরের হারের সীমা নেই৷

ডিভাইসের ধরন	ডিভাইস ইনস্ট্যান্স রেট সীমা
থার্মোস্ট্যাট	5 QPM বা 100 QPH
ক্যামেরা	30 QPM বা 100 QPH
ডোরবেল	30 QPM বা 100 QPH

ত্রুটি

নিম্নলিখিত ত্রুটি কোড(গুলি) এই নির্দেশিকা সম্পর্কিত ফেরত দেওয়া হতে পারে:

ত্রুটি বার্তা	আরপিসি	সমস্যা সমাধান
হার সীমিত।	RESOURCE_EXHAUSTED	প্রতিটি ডেভেলপারের একটি কোটা রয়েছে যাতে তারা কতগুলি কল করতে পারে তা সীমিত করে। আপনি যদি আপনার কোটার চেয়ে বেশি কল করেন তবে আপনি রেট সীমিত বার্তা পাবেন। এটি ঠিক করতে, কোটার মেয়াদ শেষ হয়ে গেলে কলটি আবার জমা দিন।

API ত্রুটি কোডের সম্পূর্ণ তালিকার জন্য API ত্রুটি কোড রেফারেন্স দেখুন।