# 插件管理

调试工具

接口应在服务器端调用,详细说明参见服务端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 找不到使用的插件