ארכיטקטורת Nest API

מידע על שירות Nest

אפליקציות Nest מאפשרות למשתמשים ליצור קשר עם הבית מכל מקום שבו הם נמצאים. כל המכשירים והתרמוסטטים של Nest (תרמוסטטים, מצלמות ומצלמות) והאפליקציות (אפליקציות ל-iOS, ל-Android ולאפליקציות אינטרנט) מתחברים לשירות Nest.

דוגמה לענן

שירות Nest מספק מודל נתונים של הבית. מכשירים ואפליקציות קוראים ממודל הנתונים הזה כדי לנקוט פעולה מתאימה. הם מעדכנים את מודל הנתונים כך שישקף את השינויים במערכת.

לדוגמה, תרמוסטט קורא את טמפרטורת היעד ממודל הנתונים. היא מגדירה את טמפרטורת הסביבה למדידה הנוכחית שלה, ושולחת את נתוני החיישנים ל-Home/Away Assist, שמתאים את מצב המבנה בהתאם.

מכשירי Nest פועלים בסביבות מוגבלות. אספקת החשמל מוגבלת והקישוריות ברשת הביתית יכולה להיות לא אמינה. המוצרים והשירותים שלך יכולים למנף את האלגוריתמים של המכשיר כדי להציע למשתמשים חוויה ביתית פשוטה ואינטואיטיבית.

מודל הנתונים

ה-Nest API מיוצג כמסמך JSON עם מאפיינים ברמה העליונה של metadata, devices וstructures. המוצרים שלך מסוג Nest with Nest משתמשים במסמך JSON זה כדי לקיים אינטראקציה עם מכשירי Nest ועם שינויים במצבם ולהגיב להם.

Nest structures מייצג מבנים פיזיים בעולם האמיתי. הם משמשים כנקודת ארגון עבור devices, והם מאחסנים נתונים של מבנה בכללותו. בדרך כלל, structure הוא בית של משתמשים.

Nest devices מייצג מכשירים פיזיים (תרמוסטטים, מגנים ומצלמות) בתוך מבנה.

ניתן לגשת לכל רכיב נתונים במסמך JSON באמצעות כתובת URL (שנקראת גם "data locations"). ניתן לעבוד עם מוצרי Nest באמצעות הקראה של קטעים במסמך הזה ולהירשם כמנוי לשינויים. היכולת הזו מאפשרת למוצרי Works with Nest להגיב בזמן אמת לשינויים שמתבצעים במערכת, כמו כיבוי האורות כאשר המשתמש מגדיר את המבנה כ'לא בבית'.

האובייקטים פועלים גם במסגרת אילוצים בעולם האמיתי. מודל הנתונים מגן על מכשירים ועל הבית של המשתמש על ידי מניעת פעולות מפתיעות ומסוכנות. לדוגמה, התרמוסטט לא מפעיל את המיזוג כשהחימום מופעל.

עיינו במודל הנתונים באמצעות ההפניה האינטראקטיבית של ה-API .

מצב מיועד

בשירות Nest מאוחסן מצב המערכת המוסמך. מוצרי Works with Nest נרשמים למינוי לשינויים. שינוי המצב הזה (לדוגמה, כדי לשנות את טמפרטורת היעד של תרמוסטט) גורם לשירות לשלוח התראה על שינוי לכל המנויים.

עקב העיכוב הזה, ייתכן שרשתות מסוימות לא יהיו אמינות ולכן המצב שמוצר מסוים צופה בו אינו המדינה הנוכחית שזוהתה במוצרים אחרים או בשירות הזה. המדינה מסונכרנת בסופו של דבר, כאשר ההודעות מועברות בין מוצרים שונים.

מודל פרסום/הרשמה זה, המבוסס על מסמכים, מספק אינטראקציות אפליקציה רספונסיביות.

השימוש בשירות Nest

כדי לגשת לנקודות הקצה של REST בשירות Nest, יש להשתמש ב-HTTPS במוצר שלך. יש הרבה ספריות לקוח של צד שלישי שבהן אפשר להשתמש למטרה הזו.

הרשאות והרשאה

אנחנו רוצים לאפשר למפתחים לבנות מוצרים ושירותים שמשפרים את הבית מבלי לפגוע בפרטיות ובאבטחה של המשתמשים. כל התקשורת שלנו מאובטחת, וההרשאה לגשת לנתונים תמיד מאושרת במפורש על ידי המשתמש. למידע נוסף, יש לעיין בסקירה הכללית של ההרשאות.

ההרשאה מטופלת על ידי פרוטוקול OAuth 2.0. כשמשתמש מביע הסכמה לספק גישה לרמת ההרשאה המבוקשת, Nest מאמת את הבקשה ואסימון גישה מוענק למגיש הבקשה. אסימון הגישה הזה יכול לשמש לגישה ל-Nest API ולאינטראקציה עם המבנים והמכשירים של המשתמש.

הקצאת אסימון גישה יוצרת קשר אמון בין המשתמש, מוצר Works with Nest ו-Nest. המשתמשים יכולים לבטל את הגישה בכל שלב.

למידע על הרשאת חיבור ל-Nest API, אפשר לעיין בסקירה הכללית של ההרשאה.