错误讯息

错误条件是开发周期的一部分，范围从简单的错误（例如无效或丢失的参数）到更复杂的场景（例如意外状态甚至与设备相关的设置），必须在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 $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`	由于不兼容的模式`$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 $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请求的模式。

例如，当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 $mode`

必须先更新设备固件，然后才能更改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指南》。

参量
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`

预计到达时间太遥远

指定的预计到达时间不能超过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 $highLockTemp`

温度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 $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设置目标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。

有关更多信息，请参见数据速率限制。