开发文档规范
范例
申请开通功能 (接口名称)
接口说明
申请开通摇一摇周边功能。成功提交申请请求后,工作人员会在三个工作日内完成审核。若审核不通过,可以重新提交申请请求。若是审核中,请耐心等待工作人员审核,在审核中状态不能再提交申请请求。
接口调用说明
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 | 联系人电话 |
是 | 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 |