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

הודעות שגיאה

תנאי שגיאה הם חלק ממחזור הפיתוח ויכולים לנוע בין תקלות פשוטות, כמו פרמטר לא חוקי או חסר, לתרחישים מורכבים יותר, כגון מצב לא צפוי או אפילו הגדרות הקשורות למכשיר, שיש לפתור מחוץ לממשק ה- 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 . הודעות יכולות להכיל מספר משתנים.

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

חָסוּם

חריגה ממגבלת התעריף .

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

לא ניתן להפעיל מאוורר במהלך כיבוי בטיחות עשן / שיתוף

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

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

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

המוצר ניסה לשנות את מצב ה- Away בזמן ש- Emergency Heat היה מופעל .

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

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

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

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

לא ניתן לשנות מצב HVAC

המצב אינו תואם את הבקשה.

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

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

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

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

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

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

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

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

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

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

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

פרמטרים
קוד מצב HTTP: 400 בקשה רעה
error לא ניתן להפעיל / לכבות את fan_timer_active עקב מצב $mode במצב לא תואם
type https://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 לערכים המותרים.
type https://developers.nest.com/reference/error-messages#invalid-fan-timer-duration
message לא ניתן להגדיר את fan_timer_duration לערך שנבחר. ראה הפניה לממשק API לערכים המותרים.

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

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

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

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

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

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

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

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

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

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

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

דרוש עדכון קושחת התקן לפני שתוכלו לשנות מצב HVAC

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

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

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

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

ETA נמצא בעבר

זמן ה- ETA שצוין הוא בעבר (לפני עכשיו). למידע נוסף על ביצוע שיחות ETA, עיין במדריך Away & ETA .

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error ETA נמצא בעבר: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
type https://developers.nest.com/reference/error-messages#eta-in-the-past
message ETA נמצא בעבר: $estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime
details $estimatedArrivalTime
$currentTime

ETA רחוקה מדי בעתיד

זמן ה- ETA שצוין לא יכול להיות יותר משמונה שעות בעתיד. לקבלת מידע נוסף על ביצוע שיחות ETA, עיין במדריך Away & ETA .

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error ETA רחוק מדי בעתיד
type https://developers.nest.com/reference/error-messages#eta-too-far-in-the-future
message ETA רחוק מדי בעתיד

fan_timer_active לא מוגדר

fan_timer_active אינו מוגדר.

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

אסור

האישורים המשמשים לגישה לשירות הקן אינם תקפים.

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

שגיאה פנימית

פרמטרים
קוד מצב HTTP: 500 שגיאת שרת פנימית
error שגיאה פנימית
type https://developers.nest.com/reference/error-messages#internal-error
message שגיאה פנימית

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

camera-id אינו חוקי.

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

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

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

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

נתיב שבר לא חוקי

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

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

מצב HVAC לא חוקי

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

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

עשן לא חוקי + מזהה אזעקה משותף

smoke_co_alarm_id אינו חוקי.

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

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

structure_id אינו תקף.

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

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

thermostat_id אינו תקף.

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

ערך לא חוקי עבור Away

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

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

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

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

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error is_streaming אינו בוליאני
type https://developers.nest.com/reference/error-messages#invalid-is-stream-format
message is_streaming אינו בוליאני

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

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

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error התווית חייבת להיות פחות מ- $max_label_length תווים
type https://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
type https://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
type https://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
type https://developers.nest.com/reference/error-messages#field-is-missing
message שדה חסר: $fieldName
details $fieldName

חסר איפה תעודת זהות

הפורמט where_id חסר.

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

אין מאוורר HVAC

נראה כי למערכת ה- HVAC יש מאוורר עצמאי.

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error אין חובב hvac
type https://developers.nest.com/reference/error-messages#no-hvac-fan
message אין חובב hvac

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

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

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

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

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

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

אין ביטול ETA חוקי לביטול

הטיול אינו תקף ולא ניתן לבטלו.

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

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

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

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

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

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

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

לא נמצא

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

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

לא במצב משם

המבנה אינו במצב משם כאשר מתבצעת שיחת ETA. שיחות ETA מתקבלות רק כאשר המבנה מוגדר כ- Away.

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

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

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

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

רק במקום שצריך לספק שם

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

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error רק במקום שצריך לספק שם
type https://developers.nest.com/reference/error-messages#extra-fields
message רק במקום שצריך לספק שם

POST אינו סוג בקשה תקף

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

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error POST אינו סוג בקשה תקף
type https://developers.nest.com/reference/error-messages#invalid-request-type
message POST אינו סוג בקשה תקף

הפרת סכמה

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

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error הפרת סכמה
type https://developers.nest.com/reference/error-messages#schema-violation-error
message הפרת סכמה

שירותים לא זמינים

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

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

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

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

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

ה- structure_id אינו תואם את חשבון המשתמש של הרשומה.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error הטמפרטורה F $tempF גבוהה מדי לטמפרטורת הנעילה $highLockTemp
type https://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
type https://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
type https://developers.nest.com/reference/error-messages#high-f-value
message ערך F טמפרטורה גבוה מדי: $tempF
details $tempF

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

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

פרמטרים
קוד מצב HTTP: 400 בקשה רעה
error ערך F טמפרטורה נמוך מדי: $tempF
type https://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 היא בתבנית שגויה
type https://developers.nest.com/reference/error-messages#format-error
message טמפרטורת $temp היא בתבנית שגויה
details $temp

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

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

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

על השדות / ים להשתמש בתבנית ISO 8601

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

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

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

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

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

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

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

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

לא ניתן ליצור איפה מזהה

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

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

לא מורשה

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

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

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

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

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

לא ידוע

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

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

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

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

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

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

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

שם כבר קיים

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

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error $name כבר קיים $name
type https://developers.nest.com/reference/error-messages#where-name-exists
message $name כבר קיים $name
details $name

איפה השם לא ניתן

where_name בשיחה.

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

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

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

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

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

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

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

איפה_הוא לא קיים

where_id אינו חוקי.

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error איפה_הוא לא קיים
type https://developers.nest.com/reference/error-messages#where-id-invalid
message איפה_הוא לא קיים
details $where_id

איפה_היד חייב להיות מחרוזת

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

פרמטרים
קוד סטטוס HTTP: 400 בקשה רעה
error איפה_היד חייב להיות מחרוזת
type https://developers.nest.com/reference/error-messages#where-id-wrong-format
message איפה_היד חייב להיות מחרוזת

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

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

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

קודי שגיאת REST

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

הודעות הגבלת שיעור REST

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

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