# 公众号关联小程序
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
linkMiniprogram
# 功能描述
该接口用于关联小程序
# 注意事项
# 关联流程(需要公众号和小程序管理员双方确认):
1、第三方平台调用接口发起关联
2、公众号管理员收到模板消息,同意关联小程序。
3、小程序管理员收到模板消息,同意关联公众号。
4、关联成功
# 其他说明
- 等待管理员同意的中间状态可使用“获取公众号关联的小程序”接口进行查询。
- 公众号需要先把“小程序管理”权限集授权给第三方平台,第三方平台才可以调用此接口进行关联和管理操作。
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/cgi-bin/wxopen/wxamplink?access_token=ACCESS_TOKEN
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:33
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用authorizer_access_token |
appid | string | 是 | 小程序 appid |
notify_users | number | 是 | 是否发送模板消息通知公众号粉丝。1表示是,0表示否。 |
show_profile | number | 是 | 是否展示公众号主页中。1表示是,0表示否。 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 返回码 |
errmsg | string | 错误信息 |
# 调用示例
示例说明: HTTPS请求
# 请求数据示例
{
"appid": "xxxxxx",
"notify_users": "1",
"show_profile": "1"
}
# 返回数据示例
{ "errcode": 0, "errmsg": "ok" }
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
-1 | system error | 系统繁忙,此时请开发者稍候再试 |
1003 | 该appid的管理员绑定的账号数量达到上限,无法转正,可到公众平台安全助手进行解除绑定之后重试 | 该appid的管理员绑定的账号数量达到上限,无法转正,可到公众平台安全助手进行解除绑定之后重试 |
1005 | 该appid的管理员手机号绑定的账号数量达到上限,无法转正,可到公众平台安全助手进行解除绑定之后重试 | 该appid的管理员手机号绑定的账号数量达到上限,无法转正,可到公众平台安全助手进行解除绑定之后重试 |
1006 | 该手机号违规命中黑名单 | |
40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |
0 | ok | ok |
89007 | 小程序本月被关联的名额已用完 | 小程序本月被关联的名额已用完 |
89008 | overseas account can not link | 小程序为海外账号,不允许关联 |
89009 | 小程序关联达到上限 | 小程序关联达到上限 |
89010 | link message has sent | 已经发送关联邀请 |
89011 | 在附近中展示的小程序不能取消关联 | 在附近中展示的小程序不能取消关联 |
89012 | can not unlink store or mall | 门店、小店小程序不能取消关联 |
89013 | 小程序被封禁 | 小程序被封禁 |
89015 | has linked wxa | 已经关联该小程序 |
89016 | 公众号本月关联相同主体达到上限 | 公众号本月关联相同主体达到上限 |
89017 | reach different realname quota | 公众号本月关联不同主体达到上限 |
89035 | linking from mp | 已经从公众平台后台发起关联申请,处于小程序管理员确认中,无法从第三方重复发起关联申请 |
89245 | mini program forbidden to link 。《允许公众号关联此小程序》开关被该小程序管理员关闭 | 可联系小程序管理员去小程序MP 设置 -> 关联公众号里重新打开 |