錯誤條件是開發週期的一部分,範圍從簡單的錯誤(例如無效或丟失的參數)到更複雜的場景(例如意外狀態甚至與設備相關的設置),必須在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 |
啟用恆溫器鎖定後無法更改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 |
不能將目標溫度設置為小於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 |
必須先更新設備固件,然後才能更改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電話的更多信息,請參閱《離開和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 |
預計到達時間太遙遠
指定的預計到達時間不能超過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 |
無效的Smoke + Co警報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 | 沒有配對的設備 |
沒有有效的預計到達時間即可取消
行程無效,無法取消。
參量 | |
---|---|
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 | 溫度C $tempC 太高,無法達到鎖定溫度$highLockTemp |
type | https://developers.nest.com/reference/error-messages#high-c-value-4-lock |
message | 溫度C $tempC 太高,無法達到鎖定溫度$highLockTemp |
details | $tempC |
溫度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 |
溫度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 |
溫度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 |
溫度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 | 無法創建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 已經存在的地方 |
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。
有關更多信息,請參見數據速率限制。