Notice: We're retiring Works with Nest. See the home page for more information.

錯誤信息

錯誤條件是開發週期的一部分，範圍可以從簡單的故障（如無效或缺少參數）到更複雜的情況，如意外狀態甚至與設備相關的設置，必須在 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`	被封鎖

在煙霧/co 安全關閉期間無法激活風扇

緊急切斷生效。在恢復正常操作之前不接受 API 調用。

參數
HTTP狀態代碼：400錯誤的請求
`error`	在煙霧/co 安全關閉期間無法激活風扇
`type`	`https://developers.nest.com/reference/error-messages#safety-shutoff-on`
`message`	在煙霧/co 安全關閉期間無法激活風扇

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

該產品試圖改變客場狀態，而急熱開始了。

參數
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 模式

模式與請求不兼容。

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

恆溫器的空調系統不支持您的產品所要求的模式： heat ， 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`

模式為 $mode 時無法設置 target_temperature

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

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

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

參數
HTTP狀態代碼：400錯誤的請求
`error`	無法設置target_temperature而模式是`$mode`
`type`	`https://developers.nest.com/reference/error-messages#mode-error`
`message`	無法設置`$fieldName` ，而模式是`$mode`
`details`	`$fieldName $mode`

需要先更新設備固件才能更改 HVAC 模式

設備必須更新到當前固件版本才能設置 Eco 溫度。

參數
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呼叫的詳細信息，請參閱客場與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 時間不能超過未來 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`

無效的暖通空調模式

恆溫的空調系統不支持由產品所要求的模式： heat ， cool ，或heat-cool 。

參數
HTTP狀態代碼：400錯誤的請求
`error`	無效的HVAC模式： `$mode`
`type`	`https://developers.nest.com/reference/error-messages#invalid-mode`
`message`	無效的HVAC模式： `$mode`
`details`	`$mode`

無效的煙霧+co 警報 ID

該smoke_co_alarm_id無效。

參數
HTTP狀態代碼：400錯誤的請求
`error`	無效的煙霧和一氧化碳報警器ID `$id`
`type`	`https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id`
`message`	無效的煙霧和一氧化碳報警器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`

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

該地方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 系統似乎沒有獨立的風扇。

參數
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帳戶配對。

參數
HTTP狀態代碼：400錯誤的請求
`error`	沒有配對的設備
`type`	`https://developers.nest.com/reference/error-messages#no-paired-devices`
`message`	沒有配對的設備

沒有可取消的有效預計到達時間

行程無效且無法取消。

參數
HTTP狀態代碼：400錯誤的請求
`error`	沒有可取消的有效預計到達時間
`type`	`https://developers.nest.com/reference/error-messages#no-valid-eta-to-cancel`
`message`	沒有可取消的有效預計到達時間

沒有字段的寫權限

客戶端對此數據沒有寫權限。欲了解更多信息，請參見權限概述。

參數
HTTP狀態代碼：400錯誤的請求
`error`	現場（S）沒有寫權限（S）： `$fields`
`type`	`https://developers.nest.com/reference/error-messages#no-write-permission`
`message`	現場（S）沒有寫權限（S）： `$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`	溫度℃ `$tempC`過高鎖溫度`$highLockTemp`
`type`	`https://developers.nest.com/reference/error-messages#high-c-value-4-lock`
`message`	溫度℃ `$tempC`過高鎖溫度`$highLockTemp`
`details`	`$tempC $highLockTemp`

溫度 C 過低，無法鎖定溫度

恆溫器已被鎖定的用戶和產品試圖設置一個攝氏目標溫度低於鎖定溫度範圍。

參數
HTTP狀態代碼：400錯誤的請求
`error`	溫度℃ `$tempC`過低鎖定溫度`$lowLockTemp`
`type`	`https://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`
`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 。攝氏溫度應為以 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`	現場（S）不能更新被修改： `$fieldNames`
`type`	`https://developers.nest.com/reference/error-messages#read-only-field-error`
`message`	現場（S）不能更新被修改： `$fieldNames`
`details`	`$fieldNames`

字段應使用 ISO 8601 格式

本場是不是在ISO 8601的格式。

參數
HTTP狀態代碼：400錯誤的請求
`error`	現場（S）應該使用ISO 8601格式： `$fieldNames`
`type`	`https://developers.nest.com/reference/error-messages#time-format-error`
`message`	現場（S）應該使用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`	此行程已被手動覆蓋

無法創建 where ID

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

參數
HTTP狀態代碼：400錯誤的請求
`error`	無法創建 where id
`type`	`https://developers.nest.com/reference/error-messages#wheres-missing`
`message`	無法創建 where 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 `$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 的長度為零

在其中name沒有定義（具有零字符）。

參數
HTTP狀態代碼：400錯誤的請求
`error`	其中 name 的長度為零
`type`	`https://developers.nest.com/reference/error-messages#zero-length-where-name`
`message`	其中 name 的長度為零

其中 name 必須是字符串

錯誤的數據類型是為發送where_name 。例如，需要字符串時的數字。

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

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和發送在短時間內過多調用，您可能會收到429請求過多HTTP響應狀態代碼。

欲了解更多信息，請參閱數據速率限制。