开发文档规范


范例

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

接口说明 

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

接口调用说明

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