微信摇一摇周边接口文档V120611.docx

微信摇一摇周边使用文档版本记录日期版本备注2015-4-9V1.0版本初始版本;2015-4-30V1.1版本更新点：摇一摇关注无需邮件申请，满500个用户自动开通；增加门店接口文档的下载；2015-6-11V1.2版本更新点：增加“申请开通摇一摇周边”接口增加“查询设备ID申请”接口；“上传图片素材”接口增加图片类型；增加接口频率限制说明；增加错误码说明；增加摇一摇事件通知；目录1前言42接口说明52.1申请开通摇一摇周边52.1.1申请开通功能52.1.2查询审核状态72.2设备管理82.2.1申请设备ID82.2.2查询设备ID申请审核状态122.2.3编辑设备信息142.2.4配置设备与门店的关联关系162.2.5查询设备列表182.3页面管理212.3.1新增页面212.3.2编辑页面信息232.3.3查询页面列表252.3.4删除页面282.4素材管理292.4.1上传图片素材292.5配置设备与页面的关联关系312.6获取摇周边的设备及用户信息332.7数据统计352.7.1以设备为维度的数据统计接口352.7.2以页面为维度的数据统计接口382.8摇一摇关注JS API412.9事件通知442.9.1摇一摇事件通知443接口频率限制说明464错误码说明485联系我们51前言摇一摇周边，是微信为线下商户提供的近距离连接用户的新玩法，支持线下商户向周边用户提供个性化信息、互动及服务等。在手机蓝牙打开的状态下，当用户在微信中打开摇一摇，如果处于iBeacon设备的信号范围内，会自动出现“周边”页卡，此时用户摇一摇就会获得周边商户所配置的信息。商户在使用摇一摇周边接口时，需先申请摇一摇周边功能，申请审核通过后，才能正常调用接口。接口说明申请开通摇一摇周边申请开通功能接口说明申请开通摇一摇周边功能。成功提交申请请求后，工作人员会在三个工作日内完成审核。若审核不通过，可以重新提交申请请求。若是审核中，请耐心等待工作人员审核，在审核中状态不能再提交申请请求。接口调用说明协议httpshttp请求方式POST请求URL/shakearound/account/register?access_token=ACCESS_TOKENPOST数据格式JSON请求参数说明参数是否必须说明access_token是调用接口凭证POST数据是JSON数据POST数据数据示例{ name: zhang_san, phone_number: email: weixin123@, industry_id: 0118, qualification_cert_urls: [ /wx_shake_bus/0/1428565236d03d864b7f43db9ce34df5f720509d0e/0, /wx_shake_bus/0/1428565236d03d864b7f43db9ce34df5f720509d0e/0 ], apply_reason: test}字段说明字段说明是否必填name联系人姓名是phone_number联系人电话是email联系人邮箱是industry_id平台定义的行业代号，具体请查看链接http://3/shake_nearby/Qualificationdocuments.html是qualification_cert_urls相关资质文件的图片url，图片需先上传至微信侧服务器，用“素材管理-上传图片素材”接口上传图片，返回的图片URL再配置在此处；当不需要资质文件时，数组内可以不填写url是apply_reason申请理由否返回数据说明正确返回JSON数据示例：{ data: { }, errcode: 0, errmsg: success.}查询审核状态接口说明查询已经提交的开通摇一摇周边功能申请的审核状态。在申请提交后，工作人员会在三个工作日内完成审核。接口调用说明协议httpshttp请求方式POST请求URL/shakearound/account/auditstatus?access_token=ACCESS_TOKENPOST数据格式JSON请求参数说明参数是否必须说明access_token是调用接口凭证POST数据否JSON数据返回数据说明正确返回JSON数据示例：{ data: { apply_time: 1432026025, audit_comment: test, audit_status: 1, audit_time: 0 }, errcode: 0, errmsg: success.}字段说明字段说明apply_time提交申请的时间戳