一、前置工作

1. 已完成淘宝开放平台入驻，拿到appkey

参考：https://www.yubaibai.com.cn/article/5594309.html

2. 提交appkey给小二，维护成云码渠道

二、接口说明

1. 设备注册

需要将现有的设备信息注册到天猫云码平台

API名称：tmall.stella.cc.device.register( 码上抢设备注册接口 )

API文档：https://open.taobao.com/api.htm?docId=46684&docType=2

参数说明：

device_sn：设备外部编码，运营商自己的设备编码

device_type：设备类型，枚举值见附录https://open.taobao.com/doc.htm?docId=118309&docType=1

primary_scene：设备点位所属的一级场景，枚举值见附录https://open.taobao.com/doc.htm?docId=118309&docType=1

secondary_scene：设备点位所属的二级场景，枚举值见附录https://open.taobao.com/doc.htm?docId=118309&docType=1

address：设备点位所在的详细地址（需包含省市区街道门牌号，确保高德地图可识别）

2. 设备更新

沿用设备注册接口，当传入的 （appkey + device_sn + device_type）在云码平台已存在时，会判定为设备更新操作。可以更新primary_scene、secondary_scene、address字段。

API名称：tmall.stella.cc.device.register( 码上抢设备注册接口 )

3. 设备状态上报

至少每24小时内回流一次设备状态给云码平台

API名称：tmall.stella.cc.device.status.update

API文档：https://open.taobao.com/api.htm?docId=44316&docType=2&scopeId=15276

参数说明：

status：设备状态。NORMAL,BROKEN

device_sn：运营商设备编码

channel_id：传入运营商的渠道ID（在这里就是appkey）

4. 设备查询API（可选实现）

API名称：tmall.stella.cc.device.status.query( 查询设备状态 )

API文档：https://open.taobao.com/api.htm?docId=46017&docType=2

版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 yubaibai360@qq.com 举报，一经查实，本站将立刻删除。