设备接入 IoTDA设备接入 IoTDA

更新时间:2021/09/06 GMT+08:00
分享

查询设备命令状态

接口说明

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

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.

处理建议:联系物联网平台维护人员。

分享:

    相关文档

    相关产品