插件管理

说明

插件管理接口详情请参考下方接口列表,但调用接口前请注意以下两点

1、当服务商调用时请使用第三方平台接口调用令牌authorizer_access_token以调用插件管理接口。

2、请务必先完成授权后再调用,否则会出现61007的错误。

接口列表

快速更新插件版本号

请求地址

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

请求参数说明

参数 类型 必填 说明
access_token String 第三方平台接口调用令牌authorizer_access_token
action String 操作类型
plugin_appid String 插件的 appid
user_version String 升级至版本号,要求此插件版本支持快速更新

操作类型说明

参数 说明
apply 申请使用插件
list 查询已添加的插件列表
unbind 删除已添加的插件
update 快速更新插件版本号

POST 数据示例(申请使用插件):

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

POST 数据示例(查询已添加的插件列表):

{
  "action": "list"
}

POST 数据示例(删除已添加的插件):

{
  "action": "unbind",
  "plugin_appid": "aaaa"
}

POST 数据示例(快速更新插件版本号):

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

返回参数说明

参数 类型 说明
errcode Number 返回码
errmsg String 错误信息
plugin_list Object Array 申请或使用中的插件信息列表,当 action == 'list' 时返回

插件信息说明

参数 类型 说明
appid String 插件 appid
status Number 插件申请状态
nickname String 插件昵称
headimgurl String 插件头像

插件申请状态说明

状态 说明
1 申请中
2 申请通过
3 被拒绝
4 申请已超时

返回结果示例(查询已添加的插件列表):

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

返回码说明

错误码 说明
0 成功
-1 系统错误
89236 该插件不能申请
89237 已经添加该插件
89238 申请或使用的插件已经达到上限
89239 该插件不存在
89243 该申请为“待确认”状态,不可删除
89244 不存在该插件 appid
89256 token 信息有误
89257 该插件版本不支持快速更新
89258 当前小程序帐号存在灰度发布中的版本,不可操作快速更新
其他错误码 请查看全局错误码