OneNET物联网平台 平台介绍 入门手册 设备开发指南 应用开发指南
API
API使用 API列表 SDK MQTT LwM2M EDP Modbus TCP
消息队列MQ HTTP推送
服务定价 扩展服务 常见问题 发布公告

设备命令

平台提供设备命令API,用于直接向设备下发单播指令
API为同步设计,即,当设备收到命令并进行应答时,API返回设备应答内容

请求语法

POST /v1/synccmds?device_id=524092364&timeout=30

<command-content>

URL参数说明

版本 类型 是否必须 说明
device_id string 设备ID
timeout string 同步API最长等待时间,取值范围 5-30, 单位秒

body说明

请求body部分为用户自定义命令数据内容

返回语法

Content-type: application/json

{
    "errno": 0,
    "error": "success",
    "data": {
        "cmd_uuid": "f9115090-8ef1-4b0c-aaf4-0678754f575a",
        "cmd_resp": "dGhpcyUyMGlzJTIwY29tbWFuZC1yZXNwb25zZSUyMGNvbnRlbnQ="
    }
}

返回参数说明

参数名称 类型 说明
errno int 错误码
error string 错误描述
cmd_uuid string 命令ID
cmd_resp string 设备应答内容,base64编码格式

返回错误码

错误码 错误描述 说明
12 device not found 设备不存在
13 device not online 设备不在线
14 cmd response timeout 设备命令应答超时

返回错误示例:

{
    "errno": 14,
    "error": "cmd response timeout"
}

使用限制

  • 命令请求body数据长度必须 小于1k
  • 设备应答时 payload 长度必须 小于1k

更多帮助

个搜索结果,搜索内容 “

    0 个搜索结果,搜索内容 “