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