**簡要描述：** * 每一件商品的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：時間錯誤，請核對 |