Architecture of the Nest API

درباره سرویس Nest

برنامه های Nest به کاربران این امکان را می دهند که از هر کجا که هستند با خانه خود ارتباط برقرار کنند. همه دستگاه‌های Nest (ترموستات، محافظ، و دوربین) و برنامه‌ها (iOS، Android، و برنامه‌های وب) به سرویس Nest متصل می‌شوند.

مثال ابر به ابر

سرویس Nest یک مدل داده از خانه ارائه می دهد. دستگاه ها و برنامه های کاربردی از این مدل داده می خوانند تا اقدام مناسب انجام دهند. آنها مدل داده را به روز می کنند تا تغییرات در سیستم را منعکس کند.

به عنوان مثال، یک ترموستات دمای مورد نظر خود را از مدل داده می خواند. دمای محیط را روی اندازه‌گیری فعلی تنظیم می‌کند و داده‌های حسگر را به Home/Away Assist ارسال می‌کند، که بر اساس آن حالت ساختار را تنظیم می‌کند.

دستگاه‌های Nest در محیط‌های محدود کار می‌کنند. قدرت محدود است و اتصال شبکه خانگی می تواند غیر قابل اعتماد باشد. محصولات و خدمات شما می توانند از الگوریتم های دستگاه ما استفاده کنند تا تجربه ای ساده و بصری در خانه را به کاربران ارائه دهند.

مدل داده

Nest API به عنوان یک سند JSON با ویژگی‌های سطح بالای metadata ، devices و structures نشان داده می‌شود. محصولات Works with Nest شما از این سند JSON برای تعامل و واکنش به دستگاه‌های Nest و تغییرات وضعیت مرتبط استفاده می‌کنند.

structures آشیانه نشان دهنده ساختارهای فیزیکی در دنیای واقعی هستند. آنها به عنوان یک نقطه سازماندهی برای devices ها عمل می کنند و داده ها را برای کل ساختمان ذخیره می کنند. به طور معمول، یک structure یک خانه کاربر است.

devices Nest نشان‌دهنده دستگاه‌های فیزیکی (ترموستات، محافظ، و دوربین) در یک ساختار هستند.

هر عنصر داده در سند JSON با URL (همچنین به عنوان "موقعیت های داده" شناخته می شود) آدرس پذیر است. Works with Nest محصولات می‌تواند در بخش‌های این سند بخواند و بنویسد و در تغییرات مشترک شود. این قابلیت اشتراک به محصولات Works with Nest اجازه می‌دهد تا در زمان واقعی به تغییرات ایجاد شده در سیستم واکنش نشان دهند، مانند خاموش کردن چراغ‌ها زمانی که کاربر ساختار را روی Away تنظیم می‌کند.

اشیا نیز تحت محدودیت های دنیای واقعی کار می کنند. مدل داده با جلوگیری از اقدامات غافلگیرکننده و خطرناک از دستگاه ها و خانه کاربر محافظت می کند. برای مثال، وقتی گرمای اضطراری فعال است، ترموستات کولر گازی را روشن نمی کند.

مدل داده را با این مرجع API تعاملی کاوش کنید.

حالت مورد نظر

سرویس Nest وضعیت معتبر سیستم را ذخیره می‌کند و محصولات Works with Nest مشترک تغییرات هستند. تغییر این حالت (مثلاً برای تغییر دمای هدف ترموستات) باعث می شود که سرویس یک اعلان تغییر را به همه مشترکین ارسال کند.

از آنجایی که این انتشار کمی تأخیر دارد و شبکه‌ها می‌توانند غیرقابل اعتماد باشند، وضعیت مشاهده شده توسط یک محصول ممکن است حالتی نباشد که در حال حاضر توسط سایر محصولات یا خدمات مشاهده می‌شود. حالت در نهایت با انتقال پیام ها بین محصولات مختلف هماهنگ می شود.

این مدل انتشار/اشتراک مبتنی بر سند، تعاملات برنامه پاسخگو را فراهم می کند.

با استفاده از سرویس Nest

برای دسترسی به نقاط پایانی REST در سرویس Nest، از HTTPS در محصول خود استفاده کنید. بسیاری از کتابخانه های مشتری شخص ثالث وجود دارد که می توان برای این منظور از آنها استفاده کرد.

مجوزها و مجوزها

ما می خواهیم به توسعه دهندگان اجازه دهیم محصولات و خدماتی را بسازند که خانه ها را بهتر می کند، بدون اینکه حریم خصوصی و امنیت کاربر به خطر بیفتد. همه ارتباطات ما امن است و اجازه دسترسی به داده ها همیشه به صراحت توسط کاربر اعطا می شود. برای اطلاعات بیشتر، به نمای کلی مجوزها مراجعه کنید.

مجوز توسط پروتکل OAuth 2.0 اداره می شود. هنگامی که کاربر موافقت می‌کند تا به سطح مجوز درخواستی دسترسی داشته باشد، Nest درخواست را احراز هویت می‌کند و رمز دسترسی به درخواست‌کننده اعطا می‌شود. این نشانه دسترسی می تواند برای دسترسی به Nest API و تعامل با ساختارها و دستگاه های کاربر استفاده شود.

اعطای رمز دسترسی، یک رابطه اعتماد بین کاربر، محصول Works with Nest و Nest برقرار می‌کند. کاربران می توانند در هر زمان دسترسی را لغو کنند.

برای آشنایی با نحوه مجوز دادن به اتصال به Nest API، به نمای کلی مجوز مراجعه کنید.