# 公众号关联小程序

调试工具

接口应在服务器端调用,详细说明参见服务端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 设置 -> 关联公众号里重新打开