錯誤訊息

錯誤條件是開發週期的一部分，範圍從簡單的錯誤（例如無效或丟失的參數）到更複雜的場景（例如意外狀態甚至與設備相關的設置），必須在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`	受阻
`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`	煙氣/公司安全關閉期間無法激活風扇

緊急加熱開啟時無法更改“離開”狀態

產品在緊急加熱打開時試圖更改“離開”狀態。

參數
HTTP狀態碼： 400錯誤的請求
`error`	緊急加熱開啟時無法更改“離開”狀態
`type`	`https://developers.nest.com/reference/error-messages#emergency-heat-is-on`
`message`	緊急加熱開啟時無法更改“離開”狀態

節能事件期間無法更改HVAC模式

Nest能源合作夥伴定義的節能活動正在生效。在節能事件結束之前，API調用將被拒絕。

參數
HTTP狀態碼： 400錯誤的請求
`error`	節能事件期間無法更改HVAC模式
`type`	`https://developers.nest.com/reference/error-messages#energy-saving-event-on`
`message`	節能事件期間無法更改HVAC模式

無法更改HVAC模式

該模式與請求不兼容。

例如，在以下情況下，您可能會收到此消息：

溫控器的HVAC系統不支持您的產品所要求的模式： heat ， cool ， heat-cool或eco
HVAC模式設置為eco ，產品嚐試設置target_temperature

參數
HTTP狀態碼： 400錯誤的請求
`error`	無法將HVAC模式更改為`$mode` ；暖通空調不能`$action`
`type`	`https://developers.nest.com/reference/error-messages#incompatible-mode`
`message`	無法將HVAC模式更改為`$mode` ；暖通空調不能`$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`	由於不兼容的模式`$mode`無法設置fan_timer_active為開/關
`type`	`https://developers.nest.com/reference/error-messages#incompatible-fan-mode`
`message`	由於不兼容的模式`$mode`無法設置fan_timer_active為開/關
`details`	`$mode`

無法將fan_timer_duration設置為所選值

產品嚐試將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_high_c為24°C時，產品嚐試將target_temperature_low_c設置為25°C。

參數
HTTP狀態碼： 400錯誤的請求
`error`	無法將目標低溫`$lowTemp`設置`$lowTemp`高於目標高溫`$highTemp`
`type`	`https://developers.nest.com/reference/error-messages#low-high-error`
`message`	無法將目標低溫`$lowTemp`設置`$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`

模式為$ mode時，無法設置target_temperature

溫控器或結構當前處於不支持API請求的模式。

例如，當HVAC系統off或處於heat-cool模式時，您無法設置target_temperature_f或target_temperature_c 。在恆溫器/結構切換回非限制模式之前，無法更改該值。

在此消息中， $fieldName可以是任何目標溫度值，而$mode可以是以下任意值： eco ， emer_heat_enable ， heat-cool ， heat ， cool ， off ， hvac_safety_shutoff_active 。

參數
HTTP狀態碼： 400錯誤的請求
`error`	模式為`$mode`無法設置target_temperature
`type`	`https://developers.nest.com/reference/error-messages#mode-error`
`message`	模式為`$mode`時，無法設置`$fieldName`
`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` ： `$error`
`type`	`https://developers.nest.com/reference/error-messages#where-id-internal`
`message`	驗證WWN字段時`$error` ： `$error`
`details`	`$error`

過去的ETA

指定的預計到達時間是過去的時間（現在之前）。有關撥打ETA電話的更多信息，請參閱《離開和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`

預計到達時間太遙遠

指定的預計到達時間不能超過8小時。有關撥打ETA呼叫的更多信息，請參閱《離開和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

禁止的

用於訪問Nest服務的憑據無效。

參數
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`	內部錯誤

無效的相機ID

camera-id無效。

參數
HTTP狀態碼： 400錯誤的請求
`error`	無效的相機ID `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-camera-id`
`message`	無效的相機ID： `$id`
`details`	`$id`

發送的內容無效

呼叫包含無效內容。例如，對布爾變量使用“ yes”而不是“ true”。

參數
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`

無效的煙霧+合作警報ID

smoke_co_alarm_id無效。

參數
HTTP狀態碼： 400錯誤的請求
`error`	無效的Smoke + Co警報ID `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id`
`message`	無效的Smoke + Co警報ID： `$id`
`details`	`$id`

無效的結構ID

structure_id無效。

參數
HTTP狀態碼： 400錯誤的請求
`error`	無效的結構ID `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-structure-id`
`message`	無效的結構ID： `$id`
`details`	`$id`

無效的恆溫器ID

thermostat_id無效。

參數
HTTP狀態碼： 400錯誤的請求
`error`	無效的恆溫器ID `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-thermostat-id`
`message`	無效的恆溫器ID： `$id`
`details`	`$id`

無效的價值

您嘗試為設定值無效away 。

參數
HTTP狀態碼： 400錯誤的請求
`error`	無效的價值
`type`	`https://developers.nest.com/reference/error-messages#invalid-away-value`
`message`	無效的值： `$value` 。僅允許“ home”和“ away”值。
`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`

超過名稱長度的最大自定義

where 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`

缺少位置ID

where_id格式丟失。

參數
HTTP狀態碼： 400錯誤的請求
`error`	缺少ID
`type`	`https://developers.nest.com/reference/error-messages#where-id-missing`
`message`	缺少ID

沒有HVAC風扇

HVAC系統似乎沒有獨立風扇。

參數
HTTP狀態碼： 400錯誤的請求
`error`	沒有暖通風扇
`type`	`https://developers.nest.com/reference/error-messages#no-hvac-fan`
`message`	沒有暖通風扇

沒有在線恆溫器

溫控器當前離線。啟用Wi-Fi後，您的產品應重新獲得訪問權限。

參數
HTTP狀態碼： 400錯誤的請求
`error`	沒有在線恆溫器
`type`	`https://developers.nest.com/reference/error-messages#no-thermostats-online`
`message`	沒有在線恆溫器

沒有配對的設備

用戶的Nest設備未與用戶的Nest帳戶配對。

參數
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`
`type`	`https://developers.nest.com/reference/error-messages#no-write-permission`
`message`	沒有字段的寫入權限： `$fields`
`details`	`$fields`

無效的請求類型

請求類型無效。例如，在需要PUT時進行了POST調用。

參數
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呼叫。

參數
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不是有效的請求類型

請求類型無效。例如，在需要PUT時進行了POST調用。

參數
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 。

參數
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 。

參數
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設置目標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`
`type`	`https://developers.nest.com/reference/error-messages#read-only-field-error`
`message`	無法在更新時修改字段： `$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`	此行程已被手動覆蓋

無法創建位置ID

wheres對象丟失。沒有定義where_id值。

參數
HTTP狀態碼： 400錯誤的請求
`error`	無法創建ID在哪裡
`type`	`https://developers.nest.com/reference/error-messages#wheres-missing`
`message`	無法創建ID所在的位置

未經授權

授權失敗。

有幾種情況可能會產生此錯誤消息：

當給定的HTTP實現沒有自動將Authorization標頭轉發到重定向的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`已存在的地方
`type`	`https://developers.nest.com/reference/error-messages#where-name-exists`
`message`	名稱`$name`已經存在的地方
`details`	`$name`

沒有提供姓名的地方

where_name中缺少where_name 。

參數
HTTP狀態碼： 400錯誤的請求
`error`	沒有提供姓名的地方
`type`	`https://developers.nest.com/reference/error-messages#where-name-missing`
`message`	沒有提供姓名的地方

名稱長度為零

未定義where 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不存在

where_id無效。

參數
HTTP狀態碼： 400錯誤的請求
`error`	where_id不存在
`type`	`https://developers.nest.com/reference/error-messages#where-id-invalid`
`message`	where_id不存在
`details`	`$where_id`

where_id必須是字符串

where_id格式無效。例如，發送了一個數字而不是一個字符串。

參數
HTTP狀態碼： 400錯誤的請求
`error`	where_id必須是字符串
`type`	`https://developers.nest.com/reference/error-messages#where-id-wrong-format`
`message`	where_id必須是字符串

其他錯誤代碼和消息

設備錯誤代碼

有關與Nest API不相關的特定於設備的錯誤代碼和消息，請參見以下內容：

REST錯誤代碼

進行REST API調用時，將返回常見的HTTP狀態代碼。

REST速率限制消息

使用REST並在短時間內發送過多呼叫時，您可能會收到HTTP響應狀態代碼429 Too Many Requests。

有關更多信息，請參見數據速率限制。