הודעות שגיאה

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

כשמתרחשת שגיאה במהלך קריאה ל-API, נשלחת תגובה בפורמט הזה:

{
  "error": "Temperature '$temp' is in wrong format",
  "type": "https://developers.nest.com/documentation/cloud/error-messages#format-error",
  "message": "Temperature '$temp' is in wrong format",
  "instance": "31441a94-ed26-11e4-90ec-1681e6b88ec1",
  "details": {
    "field_name": "$temp"
  }
}

כל הודעות השגיאה מכילות את השדות error, type, message ו-instance. האובייקט details הוא אופציונלי.

שדה תיאור
error פורמט קצר של הודעת שגיאה.
type כתובת ה-URL מספקת מידע מפורט על מצב השגיאה (בדף הזה).
message פורמט ארוך של הודעת שגיאה שעשוי להשתמש במשתנים כדי לספק פרטים נוספים. כאשר משתנה נכלל בהודעה, הוא יופיע באובייקט details.
instance מחרוזת טקסט הכוללת מזהה שגיאה ייחודי לכל שיחה. ייתכן שנבקש ממך את מספר המופע אם תדווח על בעיה בשירות.
details אופציונלי. מכיל משתנים שנוספו לmessage. ההודעות יכולות להכיל כמה משתנים.

למידע על שגיאות שאינן קשורות ל-Nest API, ניתן לעיין במאמר קודי שגיאות והודעות אחרים.

חסומות

חרגת ממגבלת התעריפים.

פרמטרים
קוד סטטוס HTTP: 429 יותר מדי בקשות
errorחסומות
typehttps://developers.nest.com/reference/error-messages#blocked
messageחסומות

לא ניתן להפעיל את המאוורר במהלך כיבוי בטיחות של גלאי עשן/פחמן חד-חמצני

כיבוי חירום מופעל. קריאות ל-API לא יתקבלו עד שהפעולה הרגילה תשוחזר.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן להפעיל את המאוורר במהלך כיבוי בטיחות של גלאי עשן/פחמן חד-חמצני
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
messageלא ניתן להפעיל את המאוורר במהלך כיבוי בטיחות של גלאי עשן/פחמן חד-חמצני

לא ניתן לשנות את המצב 'לא בבית' כאשר מקור החום למקרה חירום פועל

המוצר ניסה לשנות את המצב 'לא בבית' כאשר חימום החירום הופעל.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן לשנות את המצב 'לא בבית' כאשר מקור החום למקרה חירום פועל
typehttps://developers.nest.com/reference/error-messages#emergency-heat-is-on
messageלא ניתן לשנות את המצב 'לא בבית' כאשר מקור החום למקרה חירום פועל

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

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן לשנות את מצב בקרת האקלים בזמן אירועי חיסכון באנרגיה
typehttps://developers.nest.com/reference/error-messages#energy-saving-event-on
messageלא ניתן לשנות את מצב בקרת האקלים בזמן אירועי חיסכון באנרגיה

לא ניתן לשנות את מצב בקרת אקלים

המצב לא תואם לבקשה.

לדוגמה, ייתכן שתקבלו את ההודעה הזאת אם:

  • מערכת בקרת אקלים של התרמוסטט אינה תומכת במצב המבוקש על ידי המוצר שלך: heat, cool, heat-cool או eco
  • ההגדרה של מערכת בקרת האקלים היא eco והמוצר מנסה להגדיר target_temperature
פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן לשנות את מצב בקרת אקלים ל$mode; מערכות בקרת אקלים לא יכולות $action
typehttps://developers.nest.com/reference/error-messages#incompatible-mode
messageלא ניתן לשנות את מצב בקרת אקלים ל$mode; מערכות בקרת אקלים לא יכולות $action
details$mode
$action

לא ניתן לשנות את מצב בקרת אקלים כאשר נעילת התרמוסטט מופעלת

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן לשנות את מצב בקרת אקלים כאשר נעילת התרמוסטט מופעלת
typehttps://developers.nest.com/reference/error-messages#lock-enabled
messageלא ניתן לשנות את מצב בקרת אקלים כאשר נעילת התרמוסטט מופעלת

לא ניתן להגדיר טמפרטורות C ו-F בו-זמנית

המוצר ניסה להגדיר גם טמפרטורות יעד לצלזיוס וגם לפרנהייט בו-זמנית. המוצר צריך להגדיר רק את טמפרטורת היעד המצוינת באמצעות temperature_scale (C/F).

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן להגדיר טמפרטורות C ו-F בו-זמנית
typehttps://developers.nest.com/reference/error-messages#multiple-value-changes
messageלא ניתן להגדיר טמפרטורות C ו-F בו-זמנית

לא ניתן להגדיר את ההפעלה/לכבות את fan_timer_active עקב מצב לא תואם

המאוורר של מערכת בקרת האקלים כבר פעיל (באופן ידני על ידי המשתמש, או לפי לוח זמנים, או בגלל מחזור חימום/קירור של מערכות חימום, אוורור ומיזוג אוויר).

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן להגדיר את ההפעלה/כיבוי של fan_timer_active עקב מצב לא תואם $mode
typehttps://developers.nest.com/reference/error-messages#incompatible-fan-mode
messageלא ניתן להגדיר את ההפעלה/כיבוי של fan_timer_active עקב מצב לא תואם $mode
details$mode

לא ניתן להגדיר את הערך fan_timer_duration לערך שנבחר

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן להגדיר את הערך fan_timer_duration. לעיון בהפניות לממשק API עבור ערכים מותרים.
typehttps://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
messageלא ניתן להגדיר את הערך fan_timer_duration. לעיון בהפניות לממשק API עבור ערכים מותרים.

לא ניתן להגדיר יעד נמוך של טמפרטורה נמוכה מטמפרטורת היעד הגבוהה

התרמוסטט נמצא במצב heat-cool, והמוצר ניסה להגדיר טמפרטורת יעד נמוכה/גבוהה מחוץ לטווח. לדוגמה, המוצר ניסה להגדיר את target_temperature_low_c ל-25°C כאשר target_temperature_high_c הוא 24°C.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן להגדיר טמפרטורה נמוכה ב-$lowTemp במצב גבוה מטמפרטורת היעד הגבוהה $highTemp
typehttps://developers.nest.com/reference/error-messages#low-high-error
messageלא ניתן להגדיר טמפרטורה נמוכה ב-$lowTemp במצב גבוה מטמפרטורת היעד הגבוהה $highTemp
details$lowTemp
$highTemp

לא ניתן להגדיר טמפרטורת יעד קרוב ל-N מעלות צלזיוס

המוצר ניסה להגדיר ערך טמפרטורת יעד קרוב מדי לטמפרטורת היעד גבוהה/נמוכה (לדוגמה, target_temperature_high_f).

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן להגדיר טמפרטורת יעד קרוב ל-N מעלות צלזיוס
typehttps://developers.nest.com/reference/error-messages#range-error
messageלא ניתן להגדיר טמפרטורת יעד הקרובה ל-$min מעלות $scale
details$min
$scale

לא ניתן להגדיר יעד_טמפרטורה כאשר המצב הוא $mode

התרמוסטט או המבנה נמצאים כרגע במצב שאינו תומך בבקשות API.

לדוגמה, לא ניתן להגדיר את target_temperature_f או את target_temperature_c כשמערכת בקרת האקלים היא off או במצב heat-cool. לא ניתן לשנות את הערך עד שהתרמוסטט/מבנה יחזור למצב שאינו מוגבל.

בהודעה הזו,הערך $fieldName יכול להיות כל אחד מערכי טמפרטורת היעד ו-$mode יכול להיות כל אחד מהערכים הבאים: eco, emer_heat_enable, heat-cool, heat, cool, off, hvac_safety_shutoff_active.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן להגדיר יעד_טמפרטורה כאשר המצב הוא $mode
typehttps://developers.nest.com/reference/error-messages#mode-error
messageלא ניתן להגדיר את $fieldName כאשר המצב הוא $mode
details$fieldName
$mode

צריך לעדכן את הקושחה של המכשיר כדי לשנות את מצב בקרת האקלים

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorיש לעדכן את הקושחה של המכשיר כדי לשנות את מצב בקרת האקלים. העדכונים מתבצעים באופן אוטומטי, בדרך כלל בתוך שבוע ממועד ההשקה.
typehttps://developers.nest.com/reference/error-messages#unsupported-firmware-version
messageיש לעדכן את הקושחה של המכשיר כדי לשנות את מצב בקרת האקלים. העדכונים מתבצעים באופן אוטומטי, בדרך כלל בתוך שבוע ממועד ההשקה.

שגיאה בעת אימות שדות WWN

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorשגיאה בעת אימות שדות WWN: $error
typehttps://developers.nest.com/reference/error-messages#where-id-internal
messageשגיאה בעת אימות שדות WWN: $error
details$error

זמן ההגעה המשוער חל בעבר

זמן ההגעה המשוער שצוין הוא בעבר (לפני NOW). לקבלת מידע נוסף על ביצוע שיחות לפי זמן הגעה משוער, עיינו במדריך 'לא בבית' ו'זמן הגעה משוער'.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorזמן ההגעה המשוער חל בעבר: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
typehttps://developers.nest.com/reference/error-messages#eta-in-the-past
messageזמן ההגעה המשוער חל בעבר: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details$estimatedArrivalTime
$currentTime

זמן ההגעה המשוער רחוק מדי בעתיד

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorזמן ההגעה המשוער רחוק מדי בעתיד
typehttps://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
messageזמן ההגעה המשוער רחוק מדי בעתיד

לא הוגדר fan_timer_active

fan_timer_active אינו מוגדר.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא הוגדר fan_timer_active
typehttps://developers.nest.com/reference/error-messages#fan-timer-active-value-missing
messageלא הוגדר fan_timer_active

אסור

פרטי הכניסה המשמשים לגישה לשירות Nest אינם חוקיים.

פרמטרים
קוד סטטוס HTTP: 403 אסור
errorאסור
typehttps://developers.nest.com/reference/error-messages#forbidden
messageאסור

שגיאה פנימית

פרמטרים
קוד סטטוס HTTP: 500 Internal Server Error
errorשגיאה פנימית
typehttps://developers.nest.com/reference/error-messages#internal-error
messageשגיאה פנימית

מזהה מצלמה לא חוקי

ה-camera-id לא חוקי.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorמזהה מצלמה לא חוקי $id
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
messageמזהה מצלמה לא חוקי: $id
details$id

נשלח תוכן לא חוקי

השיחה מכילה תוכן לא חוקי. לדוגמה, שימוש ב "כן" במקום ב "נכון" למשתנה בוליאני.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorנשלח תוכן לא חוקי
typehttps://developers.nest.com/reference/error-messages#invalid-content-sent
messageנשלח תוכן לא חוקי

נתיב לא חוקי של מקטע

חלק מנתיב הבקשה אינו חוקי. לדוגמה, שגיאת איות של שם אובייקט או שדה.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorנתיב מקטע לא חוקי: $requestPath
typehttps://developers.nest.com/reference/error-messages#invalid-fragment
messageנתיב מקטע לא חוקי: $requestPath
details$requestPath

מצב לא חוקי של מערכות בקרת אקלים

מערכת בקרת האקלים של התרמוסטט לא תומכת במצב הנדרש על ידי המוצר: heat, cool או heat-cool.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorמצב לא חוקי של בקרת אקלים: $mode
typehttps://developers.nest.com/reference/error-messages#invalid-mode
messageמצב לא חוקי של בקרת אקלים: $mode
details$mode

מזהה לא חוקי של גלאי עשן ופחמן חד-חמצני

ה-smoke_co_alarm_id לא חוקי.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorמזהה $id לא חוקי של גלאי עשן ופחמן חד-חמצני
typehttps://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id
messageמזהה התראה לא חוקי של גלאי עשן/פחמן חד-חמצני: $id
details$id

מזהה מבנה לא חוקי

ה-structure_id לא חוקי.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorמזהה מבנה לא חוקי של $id
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
messageמזהה מבנה לא חוקי: $id
details$id

מזהה תרמוסטט לא חוקי

ה-thermostat_id לא חוקי.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorמזהה תרמוסטט לא חוקי $id
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
messageמזהה תרמוסטט לא חוקי: $id
details$id

ערך לא חוקי של המצב 'לא בבית'

ניסית להגדיר ערך לא חוקי עבור away.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorערך לא חוקי של המצב 'לא בבית'
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
messageערך לא חוקי: $value. רק הערכים 'home' ו-'away' מותרים.
details$value

is_streaming אינו בוליאני

המוצר ניסה להגדיר את השדה is-streaming לערך בוליאני.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
erroris_streaming אינו בוליאני
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_streaming אינו בוליאני

התווית חייבת לכלול פחות מ-256 תווים

המוצר ניסה ליצור תווית תרמוסטט עם יותר מ-256 תווים.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהתווית חייבת להיות באורך של עד $max_label_length תווים
typehttps://developers.nest.com/reference/error-messages#max-label-length
messageהתווית חייבת להיות באורך של עד $max_label_length תווים
details$max_label_length

ערך מותאם אישית מקסימלי שבו הייתה חריגה מהספירה

המוצר ניסה ליצור אובייקט wheres מותאם אישית מעבר למקסימום. מספר האובייקטים המותאם אישית wheres המותר הוא 32.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorכמות מקסימלית בהתאמה אישית, עם חריגה בספירה של $max_where_count
typehttps://developers.nest.com/reference/error-messages#max-where-count
messageכמות מקסימלית בהתאמה אישית, עם חריגה בספירה של $max_where_count
details$max_where_count

התאמה אישית מקסימלית, כאשר אורך השם חורג מהמגבלה

כאשר name ארוך מדי. אנחנו ממליצים על פחות מ-30 תווים.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorגודל מותאם אישית מקסימלי שבו האורך של שם $max_custom_where_name_length חורג
typehttps://developers.nest.com/reference/error-messages#max-where-name-length
messageגודל מותאם אישית מקסימלי שבו האורך של שם $max_custom_where_name_length חורג
details$max_custom_where_name_length

חסר שדה

בקריאה חסר פרמטר נדרש.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorשדה חסר: $fieldName
typehttps://developers.nest.com/reference/error-messages#field-is-missing
messageשדה חסר: $fieldName
details$fieldName

חסר מזהה

הפורמט של where_id חסר.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorחסר מזהה
typehttps://developers.nest.com/reference/error-messages#where-id-missing
messageחסר מזהה

אין מאוורר בקרת אקלים

נראה שמערכת בקרת האקלים אינה כוללת מאוורר עצמאי.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorאין מאוורר מערכת חימום, אוורור ומיזוג אוויר
typehttps://developers.nest.com/reference/error-messages#no-hvac-fan
messageאין מאוורר מערכת חימום, אוורור ומיזוג אוויר

אין תרמוסטטים מקוונים

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorאין תרמוסטטים מקוונים
typehttps://developers.nest.com/reference/error-messages#no-thermostats-online
messageאין תרמוסטטים מקוונים

אין מכשירים מותאמים

מכשירי Nest של המשתמש לא מותאמים לחשבון Nest של המשתמש.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorאין מכשירים מותאמים
typehttps://developers.nest.com/reference/error-messages#no-paired-devices
messageאין מכשירים מותאמים

אין זמן הגעה משוער לביטול

הנסיעה לא חוקית ולא ניתן לבטל אותה.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorאין זמן הגעה משוער לביטול
typehttps://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel
messageאין זמן הגעה משוער לביטול

אין הרשאות כתיבה בשדות

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorאין הרשאות כתיבה בשדות: $fields
typehttps://developers.nest.com/reference/error-messages#no-write-permission
messageאין הרשאות כתיבה בשדות: $fields
details$fields

סוג בקשה לא חוקי

סוג הבקשה אינו חוקי. לדוגמה, בוצעה שיחת POST כשנדרש PUT.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorסוג בקשה זה אינו חוקי: $requestType
typehttps://developers.nest.com/reference/error-messages#request-type-not-allowed
messageסוג בקשה זה אינו חוקי: $requestType
details$requestType

לא ידוע

השיחה ניסתה לקרוא נתיב שאינו קיים.

פרמטרים
קוד סטטוס HTTP: 404 לא נמצא
errorלא ידוע
typehttps://developers.nest.com/reference/error-messages#not-found
messageלא ידוע

לא במצב 'לא בבית'

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא במצב 'לא בבית'
typehttps://developers.nest.com/reference/error-messages#not-in-away-mode
messageלא במצב 'לא בבית'

לא ניתן לכתיבה

השדה שאליו ניסית לכתוב הוא לקריאה בלבד.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן לכתיבה
typehttps://developers.nest.com/reference/error-messages#not-writable
messageלא ניתן לכתיבה

יש לספק רק שם

שדות נוספים נכללו בשיחה wheres.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorיש לספק רק שם
typehttps://developers.nest.com/reference/error-messages#extra-fields
messageיש לספק רק שם

POST אינו סוג בקשה חוקי

סוג הבקשה אינו חוקי. לדוגמה, בוצעה שיחת POST כשנדרש PUT.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorPOST אינו סוג בקשה חוקי
typehttps://developers.nest.com/reference/error-messages#invalid-request-type
messagePOST אינו סוג בקשה חוקי

הפרת סכימה

אירעה שגיאה במהלך התאמת המכשירים.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהפרת סכימה
typehttps://developers.nest.com/reference/error-messages#schema-violation-error
messageהפרת סכימה

השירות לא זמין

פרמטרים
קוד סטטוס HTTP: שירות 503 לא זמין
errorהשירות אינו זמין
typehttps://developers.nest.com/reference/error-messages#service-unavailable
messageהשירות אינו זמין

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

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorבמבנה כבר יש מספר מרבי של מכשירים מותאמים
typehttps://developers.nest.com/reference/error-messages#max-number-devices-error
messageבמבנה כבר יש מספר מרבי של מכשירים מותאמים

המבנה לא בבעלות המשתמש

הכתובת structure_id לא תואמת לחשבון המשתמש של הרשומה.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהמבנה לא בבעלות המשתמש.
typehttps://developers.nest.com/reference/error-messages#structure-ownership-error-uri
messageהמבנה לא בבעלות המשתמש.

הטמפרטורה C גבוהה מדי לטמפרטורת המנעול

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorטמפרטורה C$tempC גבוה מדי לטמפרטורת המנעול$highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-c-value-4-lock
messageטמפרטורה C$tempC גבוה מדי לטמפרטורת המנעול$highLockTemp
details$tempC
$highLockTemp

הטמפרטורה C נמוכה מדי לטמפרטורת המנעול

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהטמפרטורה $tempC נמוכה מדי לטמפרטורת המנעול $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-c-value-4-lock
messageהטמפרטורה $tempC נמוכה מדי לטמפרטורת המנעול $lowLockTemp
details$tempC
$lowLockTemp

ערך הטמפרטורה C גבוה מדי

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorערך הטמפרטורה C גבוה מדי: $tempC
typehttps://developers.nest.com/reference/error-messages#high-c-value
messageערך הטמפרטורה C גבוה מדי: $tempC
details$tempC

ערך הטמפרטורה C נמוך מדי

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorערך הטמפרטורה C נמוך מדי: $tempC
typehttps://developers.nest.com/reference/error-messages#low-c-value
messageערך הטמפרטורה C נמוך מדי: $tempC
details$tempC

הטמפרטורה F גבוהה מדי לטמפרטורת המנעול

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהטמפרטורה F $tempF גבוהה מדי לטמפרטורת המנעול $highLockTemp
typehttps://developers.nest.com/reference/error-messages#high-f-value-4-lock
messageהטמפרטורה F $tempF גבוהה מדי לטמפרטורת המנעול $highLockTemp
details$tempF
$highLockTemp

הטמפרטורה F נמוכה מדי לטמפרטורת המנעול

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהטמפרטורה F $tempF נמוכה מדי לטמפרטורת המנעול $lowLockTemp
typehttps://developers.nest.com/reference/error-messages#low-f-value-4-lock
messageהטמפרטורה F $tempF נמוכה מדי לטמפרטורת המנעול $lowLockTemp
details$tempF
$lowLockTemp

ערך הטמפרטורה F גבוה מדי

המוצר ניסה להגדיר ערך טמפרטורת יעד גבוה מדי לטמפרטורה בפרנהייט. לטווחי טמפרטורות מותרים בפרנהייט ראה target_temperature_f.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorערך הטמפרטורה F גבוה מדי: $tempF
typehttps://developers.nest.com/reference/error-messages#high-f-value
messageערך הטמפרטורה F גבוה מדי: $tempF
details$tempF

ערך הטמפרטורה F נמוך מדי

המוצר ניסה להגדיר ערך טמפרטורת יעד נמוך מדי לטמפרטורה בפרנהייט. לטווחי טמפרטורות מותרים בפרנהייט ראה target_temperature_f.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorערך הטמפרטורה F נמוך מדי: $tempF
typehttps://developers.nest.com/reference/error-messages#low-f-value
messageערך הטמפרטורה F נמוך מדי: $tempF
details$tempF

הטמפרטורה היא בפורמט שגוי

המוצר ניסה להגדיר טמפרטורת יעד בפורמט שגוי של מספרים עבור temperature_scale שנבחרו. הטמפרטורות צלזיוס צריכות להיות מספרים שלמים בהפרשים של 0.5 (21.5), והטמפרטורות פרנהייט צריכות להיות מספרים שלמים (72).

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהטמפרטורה $temp היא בפורמט שגוי
typehttps://developers.nest.com/reference/error-messages#format-error
messageהטמפרטורה $temp היא בפורמט שגוי
details$temp

לא ניתן לשנות את השדות בעדכון

המוצר ניסה לכתוב בשדה לקריאה בלבד.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ניתן לשנות את השדות בעדכון: $fieldNames
typehttps://developers.nest.com/reference/error-messages#read-only-field-error
messageלא ניתן לשנות את השדות בעדכון: $fieldNames
details$fieldNames

השדות צריכים להיות בפורמט ISO 8601

הפורמט של השדה אינו ISO 8601.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהשדות צריכים להיות בפורמט ISO 8601: $fieldNames
typehttps://developers.nest.com/reference/error-messages#time-format-error
messageהשדות צריכים להיות בפורמט ISO 8601: $fieldNames
details$fieldNames

התרמוסטט לא מחובר לאינטרנט

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהתרמוסטט לא מחובר לאינטרנט
typehttps://developers.nest.com/reference/error-messages#not-online
messageהתרמוסטט לא מחובר לאינטרנט

הנסיעה הזו בוטלה באופן ידני

המשתמש ביטל את הנסיעה באופן ידני.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהנסיעה הזו בוטלה באופן ידני
typehttps://developers.nest.com/reference/error-messages#trip-manually-overidden
messageהנסיעה הזו בוטלה באופן ידני

יצירת המזהה נכשלה

האובייקט wheres חסר. לא הוגדרו ערכי where_id.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorיצירת המזהה נכשלה
typehttps://developers.nest.com/reference/error-messages#wheres-missing
messageיצירת המזהה נכשלה

לא מורשה

ההרשאה נכשלה.

יש כמה תנאים שעשויים ליצור את הודעת השגיאה הזו:

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

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

פרמטרים
קוד סטטוס HTTP: 401 לא מורשה
errorלא מורשה
typehttps://developers.nest.com/reference/error-messages#auth-error
messageלא מורשה

לא ידוע

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא ידוע
typehttps://developers.nest.com/reference/error-messages#unknown
messageלא ידוע

סוג לא ידוע של ספק/מכשיר

ספק/מכשיר לא מזוהה במהלך התאמת מכשיר.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorסוג לא ידוע של ספק/מכשיר
typehttps://developers.nest.com/reference/error-messages#unknown-vendor-device-type-error
messageסוג לא ידוע של ספק/מכשיר

הערך של $fieldName הוא מסוג שגוי

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהערך של $fieldName הוא מסוג שגוי
typehttps://developers.nest.com/reference/error-messages#wrong-data-type
messageהערך של $fieldName הוא מסוג שגוי
details$fieldName

השם כבר קיים

המוצר where_name שניסית להגדיר כבר קיים. נסו שוב עם שם חדש.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהשם $name כבר קיים
typehttps://developers.nest.com/reference/error-messages#where-name-exists
messageהשם $name כבר קיים
details$name

לא צוין שם

ה-where_name חסר בשיחה.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorלא צוין שם
typehttps://developers.nest.com/reference/error-messages#where-name-missing
messageלא צוין שם

כאשר השם הוא באורך אפס

כאשר name אינו מוגדר (כולל אפס תווים).

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorכאשר השם הוא באורך אפס
typehttps://developers.nest.com/reference/error-messages#zero-length-where-name
messageכאשר השם הוא באורך אפס

כאשר השם חייב להיות מחרוזת

סוג נתונים שגוי נשלח עבור where_name. לדוגמה, מספר הצפוי למחרוזת.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorכאשר השם חייב להיות מחרוזת
typehttps://developers.nest.com/reference/error-messages#where-name-wrong-format
messageכאשר השם חייב להיות מחרוזת

היכן שאינו קיים מזהה

ה-where_id לא חוקי.

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorהיכן שאינו קיים מזהה
typehttps://developers.nest.com/reference/error-messages#where-id-invalid
messageהיכן שאינו קיים מזהה
details$where_id

כאשר מזהה_המאפיין צריך להיות מחרוזת

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

פרמטרים
קוד סטטוס HTTP: בקשה לא תקינה מסוג 400
errorכאשר מזהה_המאפיין צריך להיות מחרוזת
typehttps://developers.nest.com/reference/error-messages#where-id-wrong-format
messageכאשר מזהה_המאפיין צריך להיות מחרוזת

הודעות וקודי שגיאה אחרים

קודים של שגיאות במכשיר

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

קודי שגיאות ב-REST

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

הודעות למגבלת קצב REST

אם תשתמשו ב-REST ותשלחו יותר מדי שיחות בפרק זמן קצר, ייתכן שתקבלו קוד סטטוס של תגובת HTTP של 429 יותר מדי בקשות.

מידע נוסף זמין בקטע מגבלות קצב נתונים.