הפניה ל- Nest API

ה-Nest API יוצר מודל של בית או בניין פיזי כמבנה, עם תרמוסטטים מסוג Nest ללמידה, Nest Protect ומצלמות Nest Cam במבנה של מכשירים. המבנה הזה מכיל גם מידע על הבית כולו (כמו מצב 'לא בבית' או 'זמן הגעה משוער', או 'שעות עומס' פעילות).

אפשר להשתמש בכל רכיב נתונים במבנה של כתובת URL של משאב (שנקראת "מיקומי נתונים") במסמך JSON משותף. כל מיקום נתונים יכול לאחסן מחרוזות, מספרים, בוליאנים, אובייקטים של הורה/צאצא או מערכים.

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

מה-API, ניתן לסנכרן נתונים ממיקומים ברמות מרובות במודל הנתונים, לדוגמה:

  • מבנה שלם, כולל כל המכשירים
  • מכשיר יחיד במבנה
  • קבוצה של ערכי נתונים (טמפרטורת הסביבה והסביבה)
  • ערך נתונים יחיד (מצב תקינות של הסוללה)

המוצרים שלכם צריכים לספק מחשבה רבה לאירועים כאלה:

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

הרשאות ונתונים משותפים של המכשיר

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

למידע נוסף, עיין בסקירה כללית של הרשאות.

נתונים ופרטיות

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

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

מטא-נתונים

מטא נתונים הם מידע נוסף שנמסר בעת ביצוע קריאה לנקודת הקצה ברמת הבסיס:

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

אסימון גישה

לאחר הרשאת משתמש, המוצר שלכם משתמש באסימון גישה לביצוע קריאות API לשירות Nest. אסימון הגישה הזה משמש כהוכחה לכך שמשתמש התיר למוצר לבצע שיחות בשמם.

פרטים
החזרותstring
דוגמה: "c.FmDPkzyzaQe..."

client_version

גרסת לקוח היא הגרסה האחרונה של לקוח שאושרה על ידי המשתמש, והיא משויכת לדומיין access_token.

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

פרטים
החזרותnumber
דוגמאות: 1, 17, 42

user_id

מזהה המשתמש מאפשר לזהות משתמשים בקריאות ל-API. המזהה הזה שונה עבור כל שילוב של מוצר ו-Nest עם המשתמש.

לדוגמה, אם למשתמש 1 יש הרשאה למוצר Works with Nest ומוצר Works with Nest מוצר B, אז למוצר A יש ערך user_id אחד למשתמש 1, ולמוצר B יש ערך user_id שונה עבור משתמש 1.

פרטים
החזרותstring
דוגמה: z.1.1.7DHps...