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

本頁面由 Cloud Translation API 翻譯而成。

錯誤訊息

錯誤狀況是開發週期的一環，範圍涵蓋簡單的錯誤 (例如無效或遺漏的參數) 和較為複雜的情況 (例如非預期的狀態，甚至是裝置相關設定)，而且這些 API 必須在 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`	提供網址錯誤詳情網頁 (本頁)。
`message`	使用變數來提供其他詳細資訊的長錯誤訊息格式。如果訊息包含變數，該變數將出現在 `details` 物件中。
`instance`	文字字串，其中包含單一呼叫專屬的錯誤 ID。如果您回報服務問題，我們可能會要求您提供執行個體編號。
`details`	選填。包含插入 `message` 的變數。訊息可以包含多個變數。

如要瞭解與 Nest 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`	緊急加熱功能開啟時無法變更外出狀態

節能活動期間無法變更空調模式

Nest 能源合作夥伴定義的節能活動生效。API 呼叫會遭到拒絕，直到節能事件結束為止。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	節能活動期間無法變更空調模式
`type`	`https://developers.nest.com/reference/error-messages#energy-saving-event-on`
`message`	節能活動期間無法變更空調模式

無法變更空調模式

模式與要求不相容。

舉例來說，系統可能會在下列情況顯示這則訊息：

Thermostat 的 HVAC 系統不支援產品要求的模式：heat、cool、heat-cool 或 eco
空調模式已設為 eco，產品會嘗試設定 target_temperature

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	無法將空調模式變更為 `$mode`；空調不能`$action`
`type`	`https://developers.nest.com/reference/error-messages#incompatible-mode`
`message`	無法將空調模式變更為 `$mode`；空調不能`$action`
`details`	`$mode $action`

啟用溫度控制器鎖定功能後，即無法變更空調模式

使用者必須解鎖溫度控制器，產品才能寫入資料。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	啟用溫度控制器鎖定功能後，即無法變更空調模式
`type`	`https://developers.nest.com/reference/error-messages#lock-enabled`
`message`	啟用溫度控制器鎖定功能後，即無法變更空調模式

無法同時設定 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_high_c 等於 24°C 時，將 target_temperature_low_c 設為 25°C。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	無法設定目標低溫 `$lowTemp` 高於目標高溫 `$highTemp`
`type`	`https://developers.nest.com/reference/error-messages#low-high-error`
`message`	無法設定目標低溫 `$lowTemp` 高於目標高溫 `$highTemp`
`details`	`$lowTemp $highTemp`

無法設定接近 N 度 C/F 的目標溫度

產品嘗試設定的目標溫度值太接近目標高/低溫度 (例如 target_temperature_high_f)。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	無法設定接近 N 度 C/F 的目標溫度
`type`	`https://developers.nest.com/reference/error-messages#range-error`
`message`	無法設定接近 `$min` 度 `$scale` 的目標溫度
`details`	`$min` `$scale`

模式為 $mode 時無法設定 target_temperature

溫度控制器或結構目前採用的是不支援 API 要求的模式。

舉例來說，如果空調系統處於 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`

必須先更新裝置韌體才能變更空調模式

您的裝置必須更新為目前的韌體版本，才能設定節能溫度。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	您必須先更新裝置韌體，才能變更空調模式。系統通常會自動進行更新，通常在發布後的一週內。
`type`	`https://developers.nest.com/reference/error-messages#unsupported-firmware-version`
`message`	您必須先更新裝置韌體，才能變更空調模式。系統通常會自動進行更新，通常在發布後的一週內。

驗證 WWN 欄位時發生錯誤

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	驗證 WWN 欄位時發生錯誤：`$error`
`type`	`https://developers.nest.com/reference/error-messages#where-id-internal`
`message`	驗證 WWN 欄位時發生錯誤：`$error`
`details`	`$error`

預計到達時間是過去的時間

指定的預計到達時間是過去的時間 (現在是現在)。要進一步瞭解如何進行 ETA 呼叫，請參閱 Away & ETA 指南。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	預計到達時間是過去的時間：`$estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime`
`type`	`https://developers.nest.com/reference/error-messages#eta-in-the-past`
`message`	預計到達時間是過去的時間：`$estimatedArrivalTime=$estimatedArrivalTime, currentTime=$currentTime`
`details`	`$estimatedArrivalTime $currentTime`

預計到達時間太遠

指定的預計到達時間不得在未來 8 小時內。要進一步瞭解如何進行 ETA 呼叫，請參閱 Away & ETA 指南。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	預計到達時間太遠
`type`	`https://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
`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 系統不支援產品要求的模式：heat、cool 或 heat-cool。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	無效的空調模式：`$mode`
`type`	`https://developers.nest.com/reference/error-messages#invalid-mode`
`message`	無效的空調模式：`$mode`
`details`	`$mode`

煙霧+co 鬧鐘 ID 無效

smoke_co_alarm_id 無效。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	煙霧+co 鬧鐘 ID `$id` 無效
`type`	`https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id`
`message`	煙霧+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'和 '外出'允許的值。
`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 個字元

本產品嘗試建立 Thermostat 標籤，且已超過 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`	缺少位置編號
`type`	`https://developers.nest.com/reference/error-messages#where-id-missing`
`message`	缺少位置編號

沒有空調電風扇

空調系統似乎沒有獨立的風扇。

參數總數
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`	沒有任何配對裝置

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

行程無效且無法取消。

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

沒有欄位的寫入權限

用戶端沒有這項資料的寫入權限。詳情請參閱權限總覽。

參數總數
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`	溫度為 `$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`	溫度 `$tempF` 的溫度過高 (以 `$highLockTemp` 的鎖定溫度來說)
`type`	`https://developers.nest.com/reference/error-messages#high-f-value-4-lock`
`message`	溫度 `$tempF` 的溫度過高 (以 `$highLockTemp` 的鎖定溫度來說)
`details`	`$tempF $highLockTemp`

溫度 F 過低，不符合鎖定溫度

使用者已經鎖定溫度控制器，導致產品嘗試設定低於鎖定溫度範圍的華氏目標溫度。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	溫度 `$tempF` 的溫度過低，無法用來鎖定鎖定溫度 (`$lowLockTemp`)
`type`	`https://developers.nest.com/reference/error-messages#low-f-value-4-lock`
`message`	溫度 `$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`
`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 端點時的權限不正確。舉例來說，如果您只為用戶端選取相機權限，則嘗試讀取 Thermostat 端點。詳情請參閱如何選擇權限。

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

參數總數
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」不存在

where_id 無效。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	「where_id」不存在
`type`	`https://developers.nest.com/reference/error-messages#where-id-invalid`
`message`	「where_id」不存在
`details`	`$where_id`

其中的 ID 必須是字串

where_id 格式無效。例如傳送數字而非字串。

參數總數
HTTP 狀態碼：400 不正確的要求
`error`	其中的 ID 必須是字串
`type`	`https://developers.nest.com/reference/error-messages#where-id-wrong-format`
`message`	其中的 ID 必須是字串

其他錯誤代碼和訊息

裝置錯誤代碼

如需裝置專屬錯誤代碼和與 Nest API 無關的訊息，請參閱下列資訊：

REST 錯誤代碼

當您傳送 REST API 呼叫時，系統將傳回一般 HTTP 狀態碼。

REST 頻率限制訊息

使用 REST 且您在短時間內傳送太多呼叫時，您可能會收到 HTTP 回應狀態碼 429 太多要求。

詳情請參閱資料傳輸上限。