錯誤訊息

錯誤狀況是開發週期的一環,範圍涵蓋簡單的錯誤 (例如無效或遺漏的參數) 和較為複雜的情況 (例如非預期的狀態,甚至是裝置相關設定),而且這些 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"
  }
}

所有錯誤訊息都包含 errortypemessageinstance 欄位。details 物件是選用項目。

欄位 說明
error 簡短的錯誤訊息格式。
type 提供網址錯誤詳情網頁 (本頁)。
message 使用變數來提供其他詳細資訊的長錯誤訊息格式。如果訊息包含變數,該變數將出現在 details 物件中。
instance 文字字串,其中包含單一呼叫專屬的錯誤 ID。如果您回報服務問題,我們可能會要求您提供執行個體編號。
details 選填。包含插入 message 的變數。訊息可以包含多個變數。

如要瞭解與 Nest API 無關的錯誤,請參閱其他錯誤代碼和訊息

已封鎖

已超過頻率限制

參數總數
HTTP 狀態碼:429 個要求過多
error已封鎖
typehttps://developers.nest.com/reference/error-messages#blocked
message已封鎖

煙霧/co 安全斷網期間無法啟動風扇

緊急關閉功能生效。在系統恢復正常運作之前,您並無法接受 API 呼叫。

參數總數
HTTP 狀態碼:400 不正確的要求
error煙霧/co 安全斷網期間無法啟動風扇
typehttps://developers.nest.com/reference/error-messages#safety-shutoff-on
message煙霧/co 安全斷網期間無法啟動風扇

緊急加熱功能開啟時無法變更外出狀態

緊急啟動功能開啟期間,該產品嘗試變更外出狀態。

參數總數
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節能活動期間無法變更空調模式

無法變更空調模式

模式與要求不相容。

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

  • Thermostat 的 HVAC 系統不支援產品要求的模式:heatcoolheat-cooleco
  • 空調模式已設為 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 開啟/關閉

HVAC 系統風扇已經受到吸引 (無論是使用者手動排程,或是按照排程執行,或是因為 HVAC 暖氣/冷氣循環而產生)。

如果您未取得預期結果,很可能是因為裝置具備內建行為,因此無法透過 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_high_c 等於 24°C 時,將 target_temperature_low_c 設為 25°C。

參數總數
HTTP 狀態碼:400 不正確的要求
error無法設定目標低溫 $lowTemp 高於目標高溫 $highTemp
typehttps://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 的目標溫度
typehttps://developers.nest.com/reference/error-messages#range-error
message無法設定接近 $min$scale 的目標溫度
details$min
$scale

模式為 $mode 時無法設定 target_temperature

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

舉例來說,如果空調系統處於 offheat-cool 模式,您就無法設定 target_temperature_ftarget_temperature_c。必須先將溫度控制器/結構切換回非受限模式,才能變更這個值。

在這個訊息中,$fieldName 可以是任何目標溫度值,而 $mode 可以是下列任一值:ecoemer_heat_enableheat-coolheatcooloffhvac_safety_shutoff_active

參數總數
HTTP 狀態碼:400 不正確的要求
error模式為$mode時無法設定 target_temperature
typehttps://developers.nest.com/reference/error-messages#mode-error
message模式為$mode時無法設定$fieldName
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

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

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

參數總數
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 小時內。要進一步瞭解如何進行 ETA 呼叫,請參閱 Away & ETA 指南

參數總數
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 內部伺服器錯誤
error內部錯誤
typehttps://developers.nest.com/reference/error-messages#internal-error
message內部錯誤

相機 ID 無效

camera-id 無效。

參數總數
HTTP 狀態碼:400 不正確的要求
error相機 ID $id 無效
typehttps://developers.nest.com/reference/error-messages#invalid-camera-id
message相機 ID 無效:$id
details$id

傳送的內容無效

通話含有無效內容。例如,為布林變數使用「yes」取代「true」。

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

空調模式無效

溫度控制器的 HVAC 系統不支援產品要求的模式:heatcoolheat-cool

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

煙霧+co 鬧鐘 ID 無效

smoke_co_alarm_id 無效。

參數總數
HTTP 狀態碼:400 不正確的要求
error煙霧+co 鬧鐘 ID $id 無效
typehttps://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 無效
typehttps://developers.nest.com/reference/error-messages#invalid-structure-id
message結構 ID 無效:$id
details$id

無效的溫度控制器 ID

thermostat_id 無效。

參數總數
HTTP 狀態碼:400 不正確的要求
error無效的溫度控制器 ID $id
typehttps://developers.nest.com/reference/error-messages#invalid-thermostat-id
message無效的溫度控制器 ID:$id
details$id

離開值無效

您嘗試為「away」設定的值無效。

參數總數
HTTP 狀態碼:400 不正確的要求
error離開值無效
typehttps://developers.nest.com/reference/error-messages#invalid-away-value
message無效的值:$value。只有 'home'和 '外出'允許的值。
details$value

is_streaming 非布林值

產品嘗試將 is-streaming 欄位設為非布林值。

參數總數
HTTP 狀態碼:400 不正確的要求
erroris_streaming 非布林值
typehttps://developers.nest.com/reference/error-messages#invalid-is-stream-format
messageis_streaming 非布林值

標籤長度不得超過 256 個字元

本產品嘗試建立 Thermostat 標籤,且已超過 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

缺少位置 ID

缺少 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

無效的要求類型

要求類型無效。例如,當需要 PUT 時,系統會發出 POST 呼叫。

參數總數
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找不到

未處於外出模式

發出 ETA 呼叫時,該結構並非處於外出模式。 只有在結構設定為「外出」時,才會接受 ETA 呼叫。

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

要求類型無效。例如,當需要 PUT 時,系統會發出 POST 呼叫。

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

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

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

參數總數
HTTP 狀態碼:400 不正確的要求
error溫度 $tempF 的溫度過低,無法用來鎖定鎖定溫度 ($lowLockTemp)
typehttps://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
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這趟行程已遭手動覆寫

無法建立地點 ID

缺少 wheres 物件。未定義任何 where_id 值。

參數總數
HTTP 狀態碼:400 不正確的要求
error無法建立地點 ID
typehttps://developers.nest.com/reference/error-messages#wheres-missing
message無法建立地點 ID

未經授權

授權失敗。

下列幾個情況可能會產生這則錯誤訊息:

  • 當某個 HTTP 實作無法自動將 Authorization 標頭轉送至重新導向的 URI 時,就會發生不正確的重新導向。詳情請參閱如何處理重新導向

  • 嘗試存取 API 端點時的權限不正確。舉例來說,如果您只為用戶端選取相機權限,則嘗試讀取 Thermostat 端點。詳情請參閱如何選擇權限

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

where_id 無效。

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

其中的 ID 必須是字串

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

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

其他錯誤代碼和訊息

裝置錯誤代碼

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

REST 錯誤代碼

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

REST 頻率限制訊息

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

詳情請參閱資料傳輸上限