**简要描述：** * 每一件商品的SN都是唯一的，通过SN码可以核实客户购买的商品属于云米的商品的真实性。第三方系统可以通过该接口维护SN信息，即添加新的SN信息。 **请求URL：** * `http://IP/doscall/oa/api/sn_maintain/r` **参数示例** ``` { "key": "……", //CTC系统指定 "data": { "type": "add", "data":[{ "pid":"1001", "sn":"000184/10000001", "mac":"gfdsffewgg", "device_type":"xxxx", "factory":"XXXXXX公司", "make_time":"2019-03-15" }, { "pid":"1002", "sn":"000184/10000002", "mac":"gsffkdieeg", "device_type":"xxxx", "factory":"XXXXXX公司", "make_time":"2019-03-30" }……] } } ``` **参数：** | 名称 | 是否必须 | 允许为空 | 描述 | 附加说明 | | --- | --- | --- | --- | --- | | type | Y | N | add | 当前只提供添加功能 | | data | Y | N | 产品sn信息 | 一次可以添加多条数据，但最多不得超过1000条 | | pid | Y | N | PID | | | sn | Y | N | SN码 | 必填，SN码必须唯一 | | mac | Y | Y | MAC | | | device\_type | Y | N | 设备类型 | | | factory | Y | Y | 生产工厂 | | | make\_time | Y | Y | 生产日期 | 格式:2019-04-01 | **返回示例** ``` { "res": 0, "msg": "", "data": [{ "res": 0, "msg": "ok" }, { "res": 1, "msg": "数据不完整" }……] } ``` **返回参数说明** | 名称 | 描述 | 附加说明 | | --- | --- | --- | | res | 0成功，其他值为失败 | 有效值：0/1/2 | | msg | 消息说明 | 0: 请求成功1：签名无效；2：参数有误 3.数据字段存在异常 4.SN码重复 5.存在云米产品库未收录的产品69码 6.请求失败 | | data | 返回结果 | key值 | | res | 0成功，其他值为失败 | 有效值：0/1/2 | | msg | 消息说明 | 0：ok 1：字段错误，请核对 2：时间错误，请核对 |