跳到主要内容

向设备下发数据

接口简述​

通过 Neptune API 向设备下发数据

operation_id 为下发数据的 ID，将会在数据下发后返回。

callback 为接口回调 URL，将会在设备成功收到推送，并且返回对应 operation_id 后请求， 请求参数为 operation_id 以及设备上传的数据。

如： "{operation_id: "xxxxxx", key1: "value1", key2: "value2}"

请求地址​

/device/pushdata

请求方式​

POST

请求参数​

序号名称必填描述
1app_id是开发者账号
2app_secret是开发者密码
3uuid是设备序列号
4data是下发数据, 格式为 JSON 字符串
如： {'0100H': 2, '0200H':'cm'}
5callback否回调URL

请求示例​

    // 使用jQuery AJax作为请求提交工具
    $.ajax({
        type: "post",
        url: "https://api.neptune-iiot.net/device/pushdata",
        dataType: "json",
        data: {
            app_id: "nep863f8291",
            app_secret: "720f8d0d3cf3b38ff190892a7840ad68",
            uuid: "0ADF-EF22-838F-122E",
            data: "{010B: 2, 020B: 3}",
            callback: "http://www.baidu.com"
        }
    });

返回值说明​

返回值格式为JSON

序号名称描述
1code请求状态:
200 = 请求成功；
401 = Token授权失败；
1001 = 设备不存在；
2message请求状态描述
3data请求结果

返回值示例​

{
    "code": 200,
    "message": "",
    "data": {
        "uuid": "0ADF-EF22-838F-122E",
        "action": "update",
        "data": {
            "010B": 2,
            "020B": 3,
            "operation_id": "559d8ee7e87c518a2d15f25cd5ad2cf8"
        },
        "operation_id": "559d8ee7e87c518a2d15f25cd5ad2cf8"
    }
}