查询设备命令状态
接口说明
应用可调用此接口查询命令状态，用于判断命令是否执行成功。
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. 处理建议：联系物联网平台维护人员。 |
Last Article: 给设备服务下发命令
Next Article: 设备侧MQTT接口参考
Did this article solve your problem?
Thank you for your score！Your feedback would help us improve the website.