微信开发：摇一摇周边功能开发步骤

微信邦

微信开发：摇一摇周边功能开发步骤

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


申请设备ID

接口说明 申请配置设备所需的UUID、Major、Minor。若激活率小于50%，不能新增设备。单次新增设备超过500个，需走人工审核流程。审核通过后，可用返回的批次ID用“查询设备列表”接口拉取本次申请的设备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

返回说明 正常时的返回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。

编辑设备信息

接口说明 编辑设备的备注信息。可用设备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."}配置设备与门店的关联关系

接口说明 修改设备关联的门店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	是	待关联的门店ID

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

{    "data": {            },    "errcode": 0,    "errmsg": "success."}查询设备列表

接口说明 查询已有的设备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超出500个时所返回批次ID
begin	是	设备列表的起始索引值
count	是	待查询的设备个数

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

{    "data": {        "devices": [            {                "comment": "",                "device_id": 10097,                "major": 10001,                "minor": 12102,                "page_ids": "15369",                "status": 1,                "poi_id": 0,                "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"            },            {                "comment": "",                "device_id": 10098,                "major": 10001,                "minor": 12103,                "page_ids": "15368",                "status": 1,                "poi_id": 0,                "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"            }         ],        "total_count": 151    },    "errcode": 0,    "errmsg": "success."}

参数说明

参数	说明
devices	指定的设备信息列表
device_id	设备编号
UUID、major、minor	UUID、major、minor
status	激活状态，0：未激活，1：已激活（但不活跃），2：活跃
poi_id	门店ID
comment	设备的备注信息
page_ids	与此设备关联的页面ID列表，用逗号隔开
total_count	商户名下的设备总量