接口描述

  • 添加云喇叭设备序列号，并绑定商户号和设备序列号

接口版本：

版本号 制定人 制定日期 修订日期
1.0.0 杨铝杰 2019-09-27 2019-09-27

请求URL：

请求方式：

  • POST

请求头

参数名 是否必须 类型 说明
Content-Type 是 String 请求类型：application/json

请求参数：

参数名 是否必须 类型 说明
appid 是 String appid
nonce_str 是 String 随机字符串
sign 是 String 签名字符串
device_list 是 array 元素为json，最多100个元素，以下为json内容
device_no 是 String 商户号+终端号（唯一值）与设备序列号绑定
device_sn 是 String 设备序列号
device_index 否 String 设备索引号，如果有多台设备时必填，默认为1

请求示例：

{
    "device_list":[{
    "device_no": "86144034816000180100001",
    "device_sn":"ZNXT041909XXXX01",
    "device_index":"1"
},{
    "device_no": "86144034816000280100002",
    "device_sn":"ZNXT041909XXXX02",
    "device_index":"2"
}],
    "appid":"2699F7FA9B4340A9E937FJUOWEIDS097FSD",
    "nonce_str":"dsf34465jkljoj254d3465758",
    "sign":"E5C1F0D2B21D1DAAA19E85B0195B1302"
}

返回参数说明:

参数名 类型 说明
code String 0000为成功，其他失败
msg String 返回消息
data json 以下为json元素
appid String appid
deviceList array 元素为json
deviceIndex String 设备索引号
deviceSN String 设备序列号
merchId String 与设备序列号绑定的商户号
message String 添加提示信息
status String 1-已注册 4-已绑定,其他状态码见附件
supplierId String 厂商号，设备序列号前四位

返回示例：

正确返回

{
    "code": "0000",
    "msg": "SUCCESS",
    "data": {
        "appid": "2699F7FA9B4340A9E937C7031XXX980X",
        "deviceList": [
            {
                "deviceIndex": "1",
                "deviceSN": "ZNXT04190900008776",
                "merchId": "86144034816800000700001",
                "message": "",
                "status": "4",
                "supplierId": "ZNXT"
            }
        ]
    }
}

备注

  • 更多返回错误代码请看错误代码描述
文档更新时间: 2020-08-21 11:21   作者：高俭