错误条件是开发周期的一部分,可能从简单的故障(如参数无效或缺失)到更复杂的场景(例如意外的状态,甚至是与设备相关的设置),而必须在 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
|
包含每个调用独有的错误标识符的文本字符串。如果您报告服务存在问题,我们可能会要求您提供实例编号。 |
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 ;HVAC 无法$action |
type | https://developers.nest.com/reference/error-messages#incompatible-mode |
message | 无法将 HVAC 模式更改为 $mode ;HVAC 无法$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
。
参数 | |
---|---|
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 摄氏度/F
产品尝试设置的目标温度值过于接近目标高温/低温(例如 target_temperature_high_f
)。
参数 | |
---|---|
HTTP 状态代码:400 请求错误 | |
error | 目标温度不得接近 N 摄氏度/F |
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 |
type | https://developers.nest.com/reference/error-messages#where-id-internal |
message | 验证 WWN 字段时出错:$error |
details | $error |
预计到达时间是过去的时间
指定的预计到达时间是过去的时间(现在是 NOW 之前)。如需详细了解如何进行 ETA 调用,请参阅外出请求 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 调用,请参阅外出请求 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 | 发送的内容无效 |
Fragment 路径无效
部分请求路径无效。例如,对象或字段名称可能拼写错误。
参数 | |
---|---|
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 | 暖通空调模式无效:$mode |
type | https://developers.nest.com/reference/error-messages#invalid-mode |
message | 暖通空调模式无效:$mode |
details | $mode |
烟雾 + co 警报 ID 无效
smoke_co_alarm_id
无效。
参数 | |
---|---|
HTTP 状态代码:400 请求错误 | |
error | 无效的烟雾 + 警报 ID $id |
type | https://developers.nest.com/reference/error-messages#invalid-smoke-co-alarm-id |
message | 无效的烟雾 + 警报 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”的值无效
您试图设置的 away
值无效。
参数 | |
---|---|
HTTP 状态代码:400 请求错误 | |
error | “Away”的值无效 |
type | https://developers.nest.com/reference/error-messages#invalid-away-value |
message | 无效值:$value 。只能使用允许值“在家”和“外出”。 |
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 个字符以上的 Thermostat 标签。
参数 | |
---|---|
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 | 地点缺失 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
使用错误的数字格式设置目标温度。摄氏度应该是以 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 实现未将授权标头自动转发到重定向的 URI,则会出现不正确的重定向。如需了解详情,请参阅如何处理重定向。
错误的权限。例如,尝试在仅为客户端选择相机权限时读取温控器端点。如需了解详情,请参阅如何选择权限。
参数 | |
---|---|
HTTP 状态代码:401 Unauthorized | |
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 |
其中,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 时,如果您在短时间内发送过多调用,则可能会收到 429 过多请求 HTTP 响应状态代码。
如需了解详情,请参阅数据速率限制。