גוגל מחויבת לקדם הון גזעי עבור קהילות שחורות. תראה איך.
דף זה תורגם על ידי Cloud Translation API.
Switch to English

ארכיטקטורת API של הקן

אודות שירות הקן

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

דוגמה לענן לענן

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

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

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

מודל הנתונים

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

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

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

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

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

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

מדינה מיועדת

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

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

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

שימוש בשירות קן

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

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

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

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

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

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