摇一摇周边开发者接口文档

微信邦

目录
1 申请设备ID
2 编辑设备信息
3 配置设备与门店的关联关系
4 查询设备列表


1，申请设备ID

接口说明 申请配置设备所需的UUID、Major、Minor。申请成功后返回批次ID，可用返回的批次ID用“查询设备列表”接口拉取本次申请的设备ID。单次新增设备超过500个，需走人工审核流程，大概需要三个工作日；单次新增设备不超过500个的，当日可返回申请的设备ID。一个公众账号最多可申请99999个设备ID，如需申请的设备ID数超过最大限额，请邮件至zhoubian@tencent.com，邮件格式如下： 标题：申请提升设备ID额度 内容：1、公众账号名称及appid（wx开头的字符串，在mp平台可查看） 2、用途 3、预估需要多少设备ID

接口调用说明

http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/device/applyid?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{   "quantity":3,           "apply_reason":"测试",           "comment":"测试专用",   "poi_id":1234        }

参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
quantity	是	申请的设备ID的数量，单次新增设备超过500个，需走人工审核流程
apply_reason	是	申请理由，不超过100个字
comment	否	备注，不超过15个汉字或30个英文字母
poi_id	否	设备关联的门店ID，关联门店后，在门店1KM的范围内有优先摇出信息的机会。门店相关信息具体可查看门店相关的接口文档

返回说明 正常时的返回JSON数据包示例：

当申请个数小于等于500时，{"data": {       "apply_id": 123,       "device_identifiers":[                        {                                "device_id":10100,                                        "uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",                                                "major":10001,                                "minor":10002                        }                ]    },    "errcode": 0,    "errmsg": "success."}当申请个数大于500时，{"data": {               "apply_id": 123,                "audit_status": 0,                        "audit_comment": "审核未通过"           },   "errcode": 0,   "errmsg": "success."}

参数说明

参数	说明
device_identifiers	指定的设备ID列表
device_id	设备编号
UUID、major、minor	UUID、major、minor
audit_status	审核状态。0：审核未通过、1：审核中、2：审核已通过；审核会在三个工作日内完成
audit_comment	审核备注，包括审核不通过的原因
apply_id	申请的批次ID，可用在“查询设备列表”接口按批次查询本次申请成功的设备ID。

2，编辑设备信息

接口说明 编辑设备的备注信息。可用设备ID或完整的UUID、Major、Minor指定设备，二者选其一。

接口调用说明

http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/device/update?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{     "device_identifier":{                "device_id":10011,                                "uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",                "major":1002,                "minor":1223        },                      "comment": “test”}

参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
device_identifier	是	指定的设备ID
device_id	是	设备编号，若填了UUID、major、minor，则可不填设备编号，若二者都填，则以设备编号为优先
UUID、major、minor	是	UUID、major、minor，三个信息需填写完整，若填了设备编号，则可不填此信息。
comment	是	设备的备注信息，不超过15个汉字或30个英文字母。

返回说明 正常时的返回JSON数据包示例：

{    "data": {        },    "errcode": 0,    "errmsg": "success."}

3，配置设备与门店的关联关系

接口说明 修改设备关联的门店ID、设备的备注信息。可用设备ID或完整的UUID、Major、Minor指定设备，二者选其一。

接口调用说明

http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/device/bindlocation?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：{     "device_identifier":{                "device_id":10011,                                "uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",                "major":1002,                "minor":1223        },      "poi_id": 1231,                }

参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
device_identifier	是	指定的设备ID
device_id	是	设备编号，若填了UUID、major、minor，则可不填设备编号，若二者都填，则以设备编号为优先
UUID、major、minor	是	UUID、major、minor，三个信息需填写完整，若填了设备编号，则可不填此信息。
poi_id	是	Poi_id 的说明改为：设备关联的门店ID，关联门店后，在门店1KM的范围内有优先摇出信息的机会。门店相关信息具体可查看门店相关的接口文档

返回说明 正常时的返回JSON数据包示例：

{    "data": {            },    "errcode": 0,    "errmsg": "success."}

4，查询设备列表

接口说明 查询已有的设备ID、UUID、Major、Minor、激活状态、备注信息、关联门店、关联页面等信息。可指定设备ID或完整的UUID、Major、Minor查询，也可批量拉取设备信息列表。

接口调用说明

http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/device/search?access_token=ACCESS_TOKENPOST数据格式：jsonPOST数据例子：查询指定设备时：{    "device_identifiers":[                 {                        "device_id":10100,                                "uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",                                        "major":10001,                        "minor":10002                }        ]}需要分页查询或者指定范围内的设备时：{    "begin": 0,                    "count": 3}当需要根据批次ID查询时：{    "apply_id": 1231,    "begin": 0,                    "count": 3}

参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
device_identifier	是	指定的设备ID
device_id	是	设备编号，若填了UUID、major、minor，则可不填设备编号，若二者都填，则以设备编号为优先
UUID、major、minor	是	UUID、major、minor，三个信息需填写完整，若填了设备编号，则可不填此信息。
apply_id	是	批次ID，申请设备ID时所返回的批次ID
begin	是	设备列表的起始索引值
count