Help Center> IoT Device Access> API Reference> 历史API> 应用侧API参考> 设备接入应用侧API参考> 设备指令下发> 查询设备命令状态
View PDF

查询设备命令状态

接口说明

应用可调用此接口查询命令状态，用于判断命令是否执行成功。

URI

请求方法

GET

URI

/api/v3.0/devices/{deviceId}/commands/{commandId}/status

传输协议

HTTPS

请求参数

名称

必选/可选

类型

位置

说明

app_key

必选

String

Header

已鉴权应用的appId。

Authorization

必选

String

Header

请求的认证信息，值为“Bearer ******”，其中******为Auth鉴权接口返回的accessToken。

deviceId

必选

String

Path

设备ID。

commandId

必选

String

Path

命令ID。

ownerAppId

可选

String

Query

资源所属应用的appId，访问其他应用所持有的资源时需要填写。

响应参数

名称

类型

说明

status

String(128)

命令状态。

请求示例

GET https://{host}:{port}/api/v3.0/devices/{deviceId}/commands/{commandId}/status?ownerAppId={ownerAppId}
Content-Type: application/json
app_key: ********
Authorization: ********

响应示例

Status Code: 200 OK

Content-Type: application/json

{
  "status" : "string"
}

错误码

HTTP状态码

HTTP状态码说明

错误码

错误码描述

200

OK

100418

The deviceData is not existed.

处理建议：请检查设备是否存在。

401

Unauthorized

100002

Invalid access token.

处理建议：获取token失败，重新登录获取token信息

403

Forbidden

100203

The application is not existed.

处理建议：检查并填写正确的appId。

404

Not Found

00014103

The device command does not exist.

处理建议：检查并填写正确的commandId。

500

Internal Server Error

100220

Get AppKey from header failed.

处理建议：联系物联网平台维护人员。
父主题： 设备指令下发