开发文档规范

范例

​申请开通功能  (接口名称)

接口说明 

申请开通摇一摇周边功能。成功提交申请请求后，工作人员会在三个工作日内完成审核。若审核不通过，可以重新提交申请请求。若是审核中，请耐心等待工作人员审核，在审核中状态不能再提交申请请求。

接口调用说明

http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/account/register?access_token=ACCESS_TOKENPOST数据格式：json
POST数据例子：
{
  "name": "zhang_san",
  "phone_number": "13512345678",
  "email": "weixin123@qq.com",
  "industry_id": "0118",
  "qualification_cert_urls": [
  "http://shp.qpic.cn/wx_shake_bus/0/1428565236d03d864b7f43db9ce34df5f720509d0e/0",
  "http://shp.qpic.cn/wx_shake_bus/0/1428565236d03d864b7f43db9ce34df5f720509d0e/0"
  ],
  "apply_reason": "test"
}

参数说明

提交参数说明

返回参数说明

参数	是否必须	数据类型	说明
access_token	是	string	调用接口凭证
name	是	string	联系人姓名，不超过20汉字或40个英文字母
phone_number	是	string	联系人电话
email	是	string	联系人邮箱
industry_id	是	string	平台定义的行业代号，具体请查看链接行业代号
qualification_cert_urls	是	array	相关资质文件的图片url，图片需先上传至微信侧服务器，用“素材管理-上传图片素材”接口上传图片，返回的图片URL再配置在此处； 当不需要资质文件时，数组内可以不填写url
apply_reason	否	string	申请理由，不超过250汉字或500个英文字母

返回说明

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

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

　　　　　　　　　　　　　　

                                       查询审核状态

接口说明 查询已经提交的开通摇一摇周边功能申请的审核状态。在申请提交后，工作人员会在三个工作日内完成审核。

接口调用说明 

http请求方式:（请使用https协议）https://api.weixin.qq.com/shakearound/account/auditstatus?access_token=ACCESS_TOKEN

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

{
    "data": {
        "apply_time": 1432026025,
        "audit_comment": "test",
        "audit_status": 1,
        "audit_time": 0
    },
    "errcode": 0,
    "errmsg": "success."
}

参数说明

提交参数说明

返回参数说明

参数	说明
apply_time	提交申请的时间戳
audit_status	审核状态。0：审核未通过、1：审核中、2：审核已通过；审核会在三个工作日内完成
audit_comment	审核备注，包括审核不通过的原因
audit_time	确定审核结果的时间戳；若状态为审核中，则该时间值为0