微信摇一摇周边接口文档_V1.2_0611

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