# 插件管理

调试工具

接口应在服务器端调用，详细说明参见服务端API。

本接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载），wx-server-sdk >= 0.4.0

# 接口说明

# 接口英文名

managePlugin

# 功能描述

该接口用于管理插件，支持申请、查看、更新、删除插件等操作。

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wxa/plugin?access_token=ACCESS_TOKEN

# 云调用

出入参和HTTPS调用相同，调用方式可查看云调用说明文档
接口方法为: openapi.pluginManager.applyPlugin

# 第三方调用

调用方式以及出入参和HTTPS相同，仅是调用的token不同
该接口所属的权限集id为：40
服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证，该参数为 URL 参数，非 Body 参数。使用access_token或者authorizer_access_token
action	string	是	action可取值为"list"、"apply"、 "unbind"、"update"，分别表示“查询已添加的插件列表”、“申请使用插件”、“删除已添加的插件”、“快速更新插件版本号”
plugin_appid	string	是	插件的 appid
reason	string	否	当action是"apply"时必填，申请原因
user_version	string	否	当action是"update"时使用。升级至版本号，要求此插件版本支持快速更新

# 返回参数

属性

类型

说明

errcode

number

错误码

errmsg

string

错误信息

plugin_list

array<object>

申请或使用中的插件信息列表，当 action == 'list' 时返回

属性	类型	说明
appid	string	插件 appId
status	number	插件状态。1表示申请中；2表示申请通过；3表示被拒绝；4表示申请已超时
nickname	string	插件昵称
headimgurl	string	插件头像

# 调用示例

示例说明: 申请插件示例

# 请求数据示例


{
  "action": "apply",
  "plugin_appid": "aaaa",
  "reason": "hello"
}

# 返回数据示例


{
  "errcode": 0,
  "errmsg": "ok"
}

示例说明: 更新插件示例

# 请求数据示例


{
  "action": "update",
  "user_version": "2.2.46",
  "plugin_appid": "wx5514af450eaceec2"
}

# 返回数据示例


{
  "errcode": 0,
  "errmsg": "ok"
}

示例说明: 获取插件列表示例

# 请求数据示例


{
  "action": "list"
}

# 返回数据示例


{
  "errcode": 0,
  "errmsg": "ok",
  "plugin_list": [
    {
      "appid": "aaaa",
      "status": 1,
      "nickname": "插件昵称",
      "headimgurl": "http://plugin.qq.com"
    }
  ]
}

# 错误码

错误码	错误码取值	解决方案
-1	system error	系统繁忙，此时请开发者稍候再试
40001	invalid credential access_token isinvalid or not latest	获取 access_token 时 AppSecret 错误，或者 access_token 无效。请开发者认真比对 AppSecret 的正确性，或查看是否正在为恰当的公众号调用接口
80067		找不到使用的插件