নেস্ট এপিআই রেফারেন্স

Nest API একটি স্ট্রাকচার হিসেবে একটি ফিজিক্যাল হোম বা বিল্ডিংকে মডেল করে, যার মধ্যে Nest Learning Thermostats, Nest Protects এবং Nest Cams স্ট্রাকচারে ডিভাইস হিসেবে থাকে। এই স্ট্রাকচারে সম্পূর্ণ বাড়ির সম্পর্কেও তথ্য রয়েছে (যেমন অ্যাওয়ে বা ইটিএ স্টেট বা সক্রিয় রাশ আওয়ার)।

কাঠামোর প্রতিটি ডেটা উপাদান একটি শেয়ার করা JSON নথিতে একটি সংস্থান URL (যাকে "ডেটা অবস্থান" বলা হয়) দ্বারা সম্বোধনযোগ্য। প্রতিটি ডেটা অবস্থান স্ট্রিং, সংখ্যা, বুলিয়ান, পিতামাতা/শিশু বস্তু, বা অ্যারে সংরক্ষণ করতে পারে।

এই ইন্টারেক্টিভ API রেফারেন্স সহ ডেটা মডেলটি অন্বেষণ করুন।

API থেকে, আপনি ডেটা মডেলের একাধিক স্তরে অবস্থান থেকে ডেটা সিঙ্ক করতে পারেন, উদাহরণস্বরূপ:

  • সমস্ত ডিভাইস সহ একটি সম্পূর্ণ কাঠামো
  • একটি কাঠামোর মধ্যে একটি একক ডিভাইস
  • ডেটা মানগুলির একটি গ্রুপ (বর্তমান এবং পরিবেষ্টিত তাপমাত্রা)
  • একটি একক ডেটা মান (ব্যাটারি স্বাস্থ্য অবস্থা)

আপনার পণ্যগুলি এই ধরনের ইভেন্টগুলিতে চিন্তাভাবনা করে প্রতিক্রিয়া জানাতে হবে:

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

অনুমতি এবং শেয়ার করা ডিভাইস ডেটা

একটি ডেটা অবস্থানে পড়ার বা লেখার ক্ষমতা অনুমতি দ্বারা নিয়ন্ত্রিত হয়। অনুমতি গোষ্ঠীগুলি ডিভাইস এবং স্ট্রাকচারে নির্বাচিত ডেটা মানগুলি পড়তে, লিখতে বা পড়তে/লেখার অ্যাক্সেস সরবরাহ করে।

আরও তথ্যের জন্য, অনুমতি ওভারভিউ দেখুন।

ডেটা এবং গোপনীয়তা

বাড়ির পণ্যের সাথে জড়িত ডেটা খুব ব্যক্তিগত হতে পারে। হোম সেন্সর ডেটাতে লোকেরা কীভাবে তাদের ব্যক্তিগত জায়গায় তাদের জীবনযাপন করে সে সম্পর্কে তথ্য রয়েছে। সেই ডেটার নিরাপত্তা এবং পরিচালনা খুবই গুরুত্বপূর্ণ এবং নেস্টে একটি উল্লেখযোগ্য ফোকাস৷ আমরা ব্যবহারকারীদের কাছে এটা পরিষ্কার করে দিই যে আমাদের কাছে কী ধরনের ডেটা আছে, এটি কীভাবে ব্যবহার করা হয় এবং তারা কোথায় এটি নিয়ন্ত্রণ করতে পারে।

গোপনীয়তা সম্পর্কে আমাদের মতামত সম্পর্কে আরও জানুন।

মেটাডেটা

মেটাডেটা হল অতিরিক্ত তথ্য যা প্রদান করা হয় যখন আপনি রুট-লেভেল এন্ডপয়েন্টে কল করেন:

https://developer-api.nest.com/

অ্যাক্সেস_টোকেন

ব্যবহারকারীর অনুমোদনের পরে, আপনার পণ্য নেস্ট পরিষেবাতে API কল করতে একটি অ্যাক্সেস টোকেন ব্যবহার করে। এই অ্যাক্সেস টোকেনটি প্রমাণ হিসাবে কাজ করে যে একজন ব্যবহারকারী আপনার পণ্যকে তাদের পক্ষে কল করার জন্য অনুমোদিত করেছেন।

বিস্তারিত
রিটার্নস string
উদাহরণ: "c.FmDPkzyzaQe..."

ক্লায়েন্ট_সংস্করণ

ক্লায়েন্ট সংস্করণটি একটি ক্লায়েন্টের সর্বশেষ ব্যবহারকারী-অনুমোদিত সংস্করণ, এবং এটি একটি access_token সাথে যুক্ত।

আপনি যখন একটি ক্লায়েন্টের জন্য অনুমতিগুলি আপডেট করেন, তখন ক্লায়েন্ট সংস্করণটি বৃদ্ধি পায় এবং ব্যবহারকারীকে জানানো হয় যে একটি আপডেট উপলব্ধ। আপনার ব্যবহারকারীরা আপনার আপডেট করা পণ্য ব্যবহার করার আগে এই ক্লায়েন্ট আপডেটটি গ্রহণ করতে হবে।

বিস্তারিত
রিটার্নস number
উদাহরণ: 1, 17, 42

ব্যবহারকারী আইডি

ব্যবহারকারী আইডি আপনাকে API কল জুড়ে ব্যবহারকারীদের সনাক্ত করতে দেয়। Nest প্রোডাক্ট এবং ব্যবহারকারীর সংমিশ্রণের প্রতিটি কাজের জন্য এই শনাক্তকারীটি আলাদা।

উদাহরণস্বরূপ, ব্যবহারকারী 1 যদি Nest প্রোডাক্ট A এর সাথে কাজ করে এবং Nest প্রোডাক্ট B এর সাথে কাজ করার অনুমোদন দিয়ে থাকে, তাহলে প্রোডাক্ট A-এর ব্যবহারকারী 1-এর জন্য একটি user_id মান থাকে এবং পণ্য B-এর ব্যবহারকারী 1-এর জন্য আলাদা user_id মান থাকে।

বিস্তারিত
রিটার্নস string
উদাহরণ: z.1.1.7DHps...