微信开发：摇一摇周边功能开发步骤
微信开发：摇一摇周边功能开发步骤
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、minorUUID、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、minorUUID、major、minor
status激活状态，0：未激活，1：已激活（但不活跃），2：活跃
poi_id门店ID
comment设备的备注信息
page_ids与此设备关联的页面ID列表，用逗号隔开
total_count商户名下的设备总量
页:
[1]