转 | 微信小程序最新API接口与插件大全推荐

摘要： 微信小程序API接口与插件大全插件管理权限集用于第三方代小程序管理插件，具体包括：添加插件、查询已添加的插件及删除插件。具体接口列表如下：1.申请使用插件2.查询已添加的插件3.删...

微信小程序API接口与插件大全

插件管理权限集用于第三方代小程序管理插件，具体包括：添加插件、查询已添加的插件及删除插件。具体接口列表如下：

1.申请使用插件

2.查询已添加的插件

3.删除已添加的插件

1.申请使用插件接口

此接口用于小程序向插件开发者发起使用插件的申请。

请求方式: POST（请使用https协议）

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

POST数据示例

参数说明

参数	说明
action	填写apply
plugin_appid	插件appid

返回说明

参数说明

参数	说明
errcode	错误码
errmsg	错误信息

错误码说明

错误码	说明
0	成功
-1	系统错误
89236	该插件不能申请
89237	已经添加该插件
89238	申请或使用的插件已经达到上限
89239	该插件不存在

2. 查询已添加的插件

此接口用于查询小程序目前已添加的插件（包括确认中、已通过、已拒绝、已超时状态）

请求方式: POST（请使用https协议）

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

POST数据示例：

参数说明

参数	说明
action	填写list

返回说明（正常时返回的json示例）

参数说明

参数	说明
errcode	错误码
errmsg	错误信息
plugin_list	申请或使用中的插件列表
appid	插件appid
status	插件状态（1：申请中，2：申请通过，3：被拒绝；4：已超时）
nickname	插件昵称
headimgurl	插件头像

错误码说明

错误码	说明
0	成功
-1	系统错误

 

 

3. 删除已添加的插件

此接口用户小程序删除当前已添加的插件（包括已通过和已拒绝）

请求方式: POST（请使用https协议）

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

POST数据示例

参数说明

参数	说明
action	填写list
plugin_appid	插件appid

返回说明（正常时返回的json示例）

错误码说明

错误码	说明
0	成功
-1	系统错误
89243	该申请为“待确认”状态，不可删除
89244	不存在该插件appid

下面对其进行详细介绍：

步骤1：第三方平台方获取预授权码（pre_auth_code）

预授权码是第三方平台方实现授权托管的必备信息，可以通过本文

步骤2：引入用户进入授权页

第三方平台方可以在自己的网站:中放置“微信公众号授权”或者“小程序授权”的入口，引导公众号和小程序管理员进入授权页。

授权页网址为：

https://mp.weixin.qq.com/cgi-bin/componentloginpage?component\_appid=xxxx&pre\_auth\_code=xxxxx&redirect\_uri=xxxx&auth\_type=xxx。

步骤3：用户确认并同意登录授权给第三方平台方

用户进入第三方平台授权页后，需要确认并同意将自己的公众号或小程序授权给第三方平台方，完成授权流程。

步骤4：授权后回调URI，得到授权码（authorization_code）和过期时间

授权流程完成后，授权页会自动跳转进入回调URI，并在URL参数中返回授权码和过期时间(redirect_url?auth_code=xxx&expires_in=600)

步骤5：利用授权码调用公众号或小程序的相关API

在得到授权码后，第三方平台方可以使用授权码换取授权公众号或小程序的接口调用凭据（authorizer_access_token，也简称为令牌），再通过该接口调用凭据，按照公众号开发者文档或小程序开发文档的说明，去调用公众号或小程序相关API。
（能调用哪些API，取决于用户将哪些权限集授权给了第三方平台方，也取决于公众号或小程序自身拥有哪些接口权限），使用JS SDK等能力。具体请见【公众号第三方平台的接口说明】

下面对各API和机制进行介绍（特别注意，所有API调用需要验证调用者IP地址。只有在第三方平台申请时填写的白名单IP地址列表内的IP地址，才能合法调用，其他一律拒绝）：

1、推送component_verify_ticket协议

在第三方平台创建审核通过后，微信服务器会向其“授权事件接收URL”每隔10分钟定时推送component_verify_ticket。第三方平台方在收到ticket推送后也需进行解密（详细请见【消息加解密接入指引】），接收到后必须直接返回字符串success。

POST数据示例

字段说明

注意：
component_verify_ticket的有效时间较component_access_token更长，建议保存最近可用的component_verify_ticket，在component_access_token过期之前使用该ticket进行更新，避免出现因为ticket接收失败而无法更新component_access_token的情况。

2、获取第三方平台component_access_token

第三方平台component_access_token是第三方平台的下文中接口的调用凭据，也叫做令牌（component_access_token）。每个令牌是存在有效期（2小时）的，且令牌的调用不是无限制的，请第三方平台做好令牌的管理，在令牌快过期时（比如1小时50分）再进行刷新。

接口调用请求说明

POST数据示例:

请求参数说明

返回结果示例

{"component_access_token":"61W3mEpU66027wgNZ_MhGHNQDHnFATkDa9-2llqrMBjUwxRSNPbVsMmyD-yq8wZETSoE5NQgecigDrSHkPtIYA", "expires_in":7200}

结果参数说明

3、获取预授权码pre_auth_code

该API用于获取预授权码。预授权码用于公众号或小程序授权时的第三方平台方安全验证。

接口调用请求说明

POST数据示例:

请求参数说明

返回结果示例

结果参数说明

4、使用授权码换取公众号或小程序的接口调用凭据和授权信息

该API用于使用授权码换取授权公众号或小程序的授权信息，并换取authorizer_access_token和authorizer_refresh_token。 授权码的获取，需要在用户在第三方平台授权页中完成授权流程后，在回调URI中通过URL参数提供给第三方平台方。请注意，由于现在公众号或小程序可以自定义选择部分权限授权给第三方平台，因此第三方平台开发者需要通过该接口来获取公众号或小程序具体授权了哪些权限，而不是简单地认为自己声明的权限就是公众号或小程序授权的权限。

接口调用请求说明

POST数据示例:

请求参数说明

返回结果示例

结果参数说明

5、获取（刷新）授权公众号或小程序的接口调用凭据（令牌）

该API用于在授权方令牌（authorizer_access_token）失效时，可用刷新令牌（authorizer_refresh_token）获取新的令牌。请注意，此处token是2小时刷新一次，开发者需要自行进行token的缓存，避免token的获取次数达到每日的限定额度。缓存方法可以参考：http://mp.weixin.qq.com/wiki/2/88b2bf1265a707c031e51f26ca5e6512.html

当换取authorizer_refresh_token后建议保存。

接口调用请求说明

POST数据示例:

请求参数说明

结果参数说明

6、获取授权方的帐号基本信息

该API用于获取授权方的基本信息，包括头像、昵称、帐号类型、认证类型、微信号、原始ID和二维码图片URL。

需要特别记录授权方的帐号类型，在消息及事件推送时，对于不具备客服接口的公众号，需要在5秒内立即响应；而若有客服接口，则可以选择暂时不响应，而选择后续通过客服接口来发送消息触达粉丝。

（1）公众号获取方法如下：

接口调用请求说明

POST数据示例:

请求参数说明

返回结果示例

结果参数说明

（2）小程序获取方法如下

接口调用请求说明

POST数据示例:

请求参数说明

返回结果示例：

返回参数说明

7、获取授权方的选项设置信息

该API用于获取授权方的公众号或小程序的选项设置信息，如：地理位置上报，语音识别开关，多客服开关。注意，获取各项选项设置信息，需要有授权方的授权，详见权限集说明。

接口调用请求说明

POST数据示例

请求参数说明

返回结果示例

结果参数说明

8、设置授权方的选项信息

该API用于设置授权方的公众号或小程序的选项信息，如：地理位置上报，语音识别开关，多客服开关。注意，设置各项选项设置信息，需要有授权方的授权，详见权限集说明。

接口调用请求说明

POST数据示例

请求参数说明

返回结果示例

结果参数说明

选项名和选项值表

9、推送授权相关通知

当公众号对第三方平台进行授权、取消授权、更新授权后，微信服务器会向第三方平台方的授权事件接收URL（创建第三方平台时填写）推送相关通知。

POST数据示例（授权成功通知）

POST数据示例（取消授权通知）

POST数据示例（授权更新通知）

第三方平台方在收到授权相关通知后也需进行解密（详细请见【消息加解密接入指引】），接收到后之后只需直接返回字符串success。为了加强安全性，postdata中的xml将使用服务申请时的加解密key来进行加密，具体请见【公众号第三方平台的加密解密技术方案】

字段说明：