錯誤狀況是開發週期的一環,範圍涵蓋簡單的錯誤 (例如無效或遺漏的參數) 和較為複雜的情況 (例如非預期的狀態,甚至是裝置相關設定),而且這些 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 |
啟用溫度控制器鎖定功能後,即無法變更空調模式
使用者必須解鎖溫度控制器,產品才能寫入資料。
參數總數 | |
---|---|
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 |
無法設定接近 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 |
必須先更新裝置韌體才能變更空調模式
您的裝置必須更新為目前的韌體版本,才能設定節能溫度。
參數總數 | |
---|---|
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 |
預計到達時間太遠
指定的預計到達時間不得在未來 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 |
鎖定溫度時,溫度 C 過低
使用者已經鎖定溫度控制器,且產品嘗試設定的攝氏溫度目標低於鎖定溫度範圍。
參數總數 | |
---|---|
HTTP 狀態碼:400 不正確的要求 | |
error | 「$tempC 」的溫度設定過低,以低於鎖定溫度 $lowLockTemp |
type | https://developers.nest.com/reference/error-messages#low-c-value-4-lock |
message | 「$tempC 」的溫度設定過低,以低於鎖定溫度 $lowLockTemp |
details | $tempC |
溫度 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 |
溫度 F 過低,不符合鎖定溫度
使用者已經鎖定溫度控制器,導致產品嘗試設定低於鎖定溫度範圍的華氏目標溫度。
參數總數 | |
---|---|
HTTP 狀態碼:400 不正確的要求 | |
error | 溫度 $tempF 的溫度過低,無法用來鎖定鎖定溫度 ($lowLockTemp ) |
type | https://developers.nest.com/reference/error-messages#low-f-value-4-lock |
message | 溫度 $tempF 的溫度過低,無法用來鎖定鎖定溫度 ($lowLockTemp ) |
details | $tempF |
溫度 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 太多要求。
詳情請參閱資料傳輸上限。