API 错误代码参考

Smart Device Management API 使用标准的 gRPC 错误代码。更多信息 请参阅错误处理

API 中的错误响应采用以下格式:

{
  "error": {
    "code": 404,
    "message": "Device enterprises/project-id/devices/device-id not found.",
    "status": "NOT_FOUND"
  }
}

使用“错误代码”表格中的搜索框查找 API 错误以及 问题排查提示以及相关特征和指南。你可以搜索内容 。

错误消息 HTTP RPC 问题排查
相机图片已不再可供下载。 504 DEADLINE_EXCEEDED 活动图片会在活动发布 30 秒后过期。请务必在到期前下载图片。

另请参阅:
下载相机图片任务
显示设备
门铃设备
事件指南
GenerateImage 命令
CameraMotion trait
CameraPerson trait
CameraSound trait
DoorbellChime trait
不支持门铃命令。 400 FAILED_PRECONDITION 无法在电池供电的门铃上扩展 WebRTC 流。如果需要在初始会话时长过后观看门铃上的直播,请停止现有直播并生成新的直播。

另请参阅:
扩展直播任务
ExtendWebRtcStream 命令
不允许在当前温控器模式下执行该命令。 400 FAILED_PRECONDITION 根据 ThermostatMode 特征,某些温控器型号不支持在温控器关闭时更改节能模式。必须先将温控器模式更改为“制热”、“制冷”或“HEATCOOL”,然后才能更改节能模式。

另请参阅:
更改模式任务
SetMode 命令
ThermostatMode trait
ThermostatTemperatureSetpoint trait
当温控器处于 MANUAL_ECO 模式时,不允许使用该命令。 400 FAILED_PRECONDITION 当温控器处于手动节能模式时,无法设置温度设定值。

另请参阅:
更改温度设定值任务
ThermostatEco trait
ThermostatTemperatureSetpoint trait
未提供命令。 404 NOT_FOUND 执行了一个命令,但请求正文中没有有效的命令名称。请输入有效的命令。
命令不受支持。 400 INVALID_ARGUMENT 针对支持 WebRTC 的摄像头使用了 RTSP 直播命令,针对支持 RTSP 的摄像头使用了 WebRTC 直播命令。

另请参阅:
下载相机图片任务
包含无效值。 400 INVALID_ARGUMENT 提交的命令的参数值无效。请确保发送有效值。
制冷值必须大于热值。 400 INVALID_ARGUMENT 请确保命令中的 heatCelsius 字段小于 coolCelsius 字段。

另请参阅:
更改温度设定值任务
ThermostatTemperatureSetpoint trait
找不到设备。 404 NOT_FOUND 指定的设备名称无效或缺失。请指定有效的设备。

另请参阅:
互联 特征
找不到企业。 404 NOT_FOUND 指定的 Project ID 无效或缺失。请指定有效的 Project ID。
事件 ID 不属于相机。 400 FAILED_PRECONDITION 使用相机事件返回的正确 eventID

另请参阅:
处理相机事件任务
显示设备
处理门铃和摄像头事件任务
事件指南
CameraEventImage trait
CameraMotion trait
CameraPerson trait
CameraSound trait
DoorbellChime trait
由于超时,未能检索到应答 SDP。 504 DEADLINE_EXCEEDED 请尝试重新生成 WebRTC 直播。

另请参阅:
特征中不存在此字段。 400 INVALID_ARGUMENT 为某个特征发送了一条不受支持的命令。
无效的优惠 SDP 缺少 CRLF。 400 INVALID_ARGUMENT 尝试生成 WebRTC 流时,offerSdp 字符串的末尾缺少换行符。请确保 offerSdp 字符串以 \r\n\n 结尾,然后尝试重新生成音频流。

另请参阅:
优惠 SDP m 行无效。 400 INVALID_ARGUMENT 提供 SDP 必须按顺序包含这 3 个音频、视频和应用 m-line。

另请参阅:
优惠 SDP 无效。 400 INVALID_ARGUMENT 提供 SDP 音频必须设置为 a=recvonly(仅限接收)。

另请参阅:
权限遭拒。 403 PERMISSION_DENIED user 尚未将 developer 拥有执行

生成 WebRTC 直播视频流时 表示 offerSdp 中的音频设置不正确。

另请参阅:
关联您的账号任务
GenerateWebRtcStream 命令
速率限制。 429 RESOURCE_EXHAUSTED 每个开发者都有一个配额,限制了他们可以进行的调用次数。如果您进行的调用次数超过配额,则会收到“频率受限”消息。要解决此问题,请在配额过期后重新提交调用。

另请参阅:
沙盒速率限制概念
找不到会议室。 404 NOT_FOUND 建筑物中没有房间。对 Room 资源发出列表调用以验证客房 ID。
找不到结构。 404 NOT_FOUND Project中不存在相应结构。对结构资源进行列表调用以验证结构 ID。
摄像头无法进行直播。 400 FAILED_PRECONDITION 摄像头处于离线状态或由于技术问题而无法进行直播。

另请参阅:
相机设备
相机(电池)设备
摄像头(有线)设备
门铃(电池)设备
门铃(有线)设备
GenerateWebRtcStream 命令
温控器风扇不可用。 400 FAILED_PRECONDITION 温控器不具备风扇功能。此设备无法使用粉丝相关特征和指令。

另请参阅:
打开或关闭风扇”任务
Fan trait