小程序管理权限集¶
为帮助公众号通过第三方关联、管理小程序，公众平台把关联小程序及相关管理功能添加到 “小程序管理”权限集。公众号需要先把该权限集授权给第三方平台，第三方平台才可以调用此接口进行关联和管理操作。
1.获取公众号关联的小程序¶
请求方式: POST（请使用 https 协议）
https://api.weixin.qq.com/cgi-bin/wxopen/wxamplinkget?access_token=TOKEN
无需携带的参数
返回说明
{
"errcode" : 0,
"errmsg" : "ok",
"wxopens" : {
"items" : [
{
"status" : 1,
"username" : "gh_xxxxxxxxx",
"source" : "SOURCE_NORMAL",
"nickname" : "aaaaaaa",
"selected" : 1,
"nearby_display_status" : 0,
"released" : 1,
"headimg_url" : "http://xxx.png",
"func_infos" : [
{
"status" : 0,
"id" : 1,
"name" : "微信认证"
},
{
"status" : 0,
"id" : 2,
"name" : "微信支付"
}
],
"copy_verify_status" : 1,
"email" : "xxxx@qq.com"
},
{
"status" : 3,
"username" : "gh_xxxxxxxxxx",
"source" : "SOURCE_NORMAL",
"headimg_url" : "http://yyy.png",
"func_infos" : []
"nickname" : "bbbbbbb"
},
]
}
}
参数说明
参数 |
说明 |
|---|---|
errcode |
错误码 |
errmsg |
错误信息 |
wxopens |
关联的小程序列表，具有 items 字段，内带有参数: |
status：关联状态 1：已关联；2：等待小程序管理员确认中；3：小程序管理员拒绝关联 12：等到公众号管理员确认中； |
|
username：小程序 gh_id |
|
nickname：小程序名称 |
|
selected：是否在公众号管理页展示中 |
|
nearby_display_status：是否展示在附近的小程序中 |
|
released：是否已经发布 |
|
headimg_url：头像 url |
|
func_info：微信认证及支付信息，0 表示未开通，1 表示开通 |
|
email：小程序邮箱 |
2. 关联小程序¶
关联流程（需要公众号和小程序管理员双方确认）：
第三方平台调用接口发起关联
公众号管理员收到模板消息，同意关联小程序。
小程序管理员收到模板消息，同意关联公众号。
关联成功
等待管理员同意的中间状态可使用“获取公众号关联的小程序”接口进行查询。
请求方式:
POST（请使用 https 协议）
https://api.weixin.qq.com/cgi-bin/wxopen/wxamplink?access_token=TOKEN
请求示例：
{
"appid": "xxxxxx",
"notify_users": "1",
"show_profile": "1"
}
需携带的参数如下
参数 |
说明 |
|---|---|
appid |
小程序 appid |
notify_users |
是否发送模板消息通知公众号粉丝 |
show_profile |
是否展示公众号主页中 |
返回说明
{
"errcode": 0,
"errmsg": "ok"
}
参数说明
参数 |
说明 |
|---|---|
errcode |
错误码 |
errmsg |
错误信息 |
3.解除已关联的小程序¶
请求方式: POST（请使用 https 协议）
https://api.weixin.qq.com/cgi-bin/wxopen/wxampunlink?access_token=TOKEN
请求示例
{
"appid": "xxxxxx"
}
需携带的参数如下
参数 |
说明 |
|---|---|
appid |
小程序 appid |
返回说明
{
"errcode": 0,
"errmsg": "ok"
}
参数说明
参数 |
说明 |
|---|---|
errcode |
错误码 |
errmsg |
错误信息 |
错误码说明
错误码 |
错误说明 |
|---|---|
89007 |
小程序本月被关联的名额已用完 |
89008 |
小程序为海外帐号，不允许关联 |
89009 |
小程序关联达到上限 |
89010 |
已经发送关联邀请 |
89011 |
在附近中展示的小程序不能取消关联 |
89012 |
门店、小店小程序不能取消关联 |
89013 |
小程序被封禁 |
89015 |
已经关联该小程序 |
89016 |
公众号本月关联相同主体达到上限 |
89017 |
公众号本月关联不同主体达到上限 |
89035 |
已经从公众平台后台发起关联申请，处于小程序管理员确认中，无法从第三方重复发起关联申请 |