# 插件申请管理
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:managePluginApplication
该接口供插件开发者调用,用于获取当前所有插件使用方信息以及修改插件使用申请的状态
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/devplugin?access_token=ACCESS_TOKEN
支持加密请求: 本接口支持服务通信二次加密和签名,可有效防止数据篡改与泄露。查看详情
# 云调用
调用方法:pluginManager.getPluginDevApplyList
出入参和 HTTPS 调用相同,调用方式可查看 云调用 说明文档
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为:40
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 接口调用凭证,可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| action | string | 是 | dev_agree表示同意申请、dev_refuse表示拒绝申请、dev_delete表示删除已拒绝的申请者、dev_apply_list表示获取当前所有插件使用方信息 |
| appid | string | 否 | action为"dev_agree"时填写,使用者的 appid,同意申请时填写。 |
| page | number | 否 | action为"dev_apply_list"时填写,要拉取第几页的数据 |
| num | number | 否 | action为"dev_apply_list"时填写,每页的记录数 |
| reason | string | 否 | action为"dev_refuse"时填写,拒绝理由。 |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| apply_list | objarray | 插件使用方列表,action为"dev_apply_list"时返回 |
# Res.apply_list(Array) Object Payload
插件使用方列表,action为"dev_apply_list"时返回
| 参数名 | 类型 | 说明 |
|---|---|---|
| appid | string | 使用者的appid |
| status | number | 插件状态 |
| nickname | string | 使用者的昵称 |
| headimgurl | string | 使用者的头像 |
| reason | string | 使用者的申请说明 |
| apply_url | string | 使用者的小程序码 |
| create_time | string | 使用者的申请时间 |
| categories | objarray | 使用者的类目 |
# Res.apply_list(Array).categoriesObject Payload
Object Payload使用者的类目
| 参数名 | 类型 | 说明 |
|---|---|---|
| first | string | 一级类目名称 |
| second | string | 二级类目名称 |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
# 5.1 获取当前所有插件使用方示例
请求示例
{
"action": "dev_apply_list",
"page": 1,
"num": 10
}
返回示例
{
"errcode": 0,
"errmsg": "ok",
"apply_list": [
{
"appid": "xxxxxxxxxxxxx",
"status": 1,
"nickname": "名称",
"headimgurl": "**********",
"reason": "polo has gone",
"apply_url": "*******",
"create_time": "1536305096",
"categories": [
{
"first": "IT科技",
"second": "硬件与设备"
}
]
}
]
}
# 5.2 修改插件使用申请的状态示例
请求示例
{
"action": "dev_agree",
"appid": "aaaa"
}
返回示例
{
"errcode": 0,
"errmsg": "ok"
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |
# 7. 适用范围
本接口支持「小程序」账号类型调用。其他账号类型如无特殊说明,均不可调用。