# 添加半屏小程序

本接口用于添加半屏小程序,使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

# 使用说明

1、如果被添加的半屏小程序设置为"需管理员验证",那么调用该接口申请添加半屏小程序后,会下发模板消息至被添加的半屏小程序管理员,需等对方管理员同意后方可添加成功,可通过get_list接口查看通过状态。

2、如果被添加的半屏小程序设置为"自动授权通过",那么调用该接口申请添加半屏小程序后,即可添加成功,可通过get_list接口查看通过状态。

3、如果被添加的半屏小程序设置为"拒绝授权邀请",那么调用该接口申请添加半屏小程序后,即刻被拒绝,可通过get_list接口查看通过状态。

4、一个小程序最多可调用10个半屏小程序;一天最多申请50个半屏小程序;

5、服务商一天最多可通过api代10个小程序申请添加同一个半屏小程序;

6、一个半屏小程序最多可授权给1000个小程序调用;

7、24h内,最多申请3次同一个半屏小程序;

# 其他使用限制

# 请求地址

POST https://api.weixin.qq.com/wxaapi/wxaembedded/add_embedded?access_token=ACCESS_TOKEN

# 请求参数说明

参数 类型 必填 说明
access_token String 第三方平台接口调用令牌authorizer_access_token
appid string 添加的半屏小程序 appid
apply_reason string 申请理由,不超过 30 个字

POST 数据示例:

{
  "appid": "wxf074af703a2e9303",
  "apply_reason": "我要申请"
}

# 返回参数说明

参数 类型 说明
errcode number 返回码
errmsg string 错误信息

返回结果示例:

{
    "errcode": 0,
    "errmsg": "ok"
}

# 返回码说明

返回码 说明
-1 系统繁忙
0 成功
89408 "半屏小程序系统错误"
89409 "获取半屏小程序列表参数错误"
89410 "添加半屏小程序appid参数错误"
89411 "添加半屏小程序appid参数为空"
89412 "添加半屏小程序申请理由不得超过30个字"
89413 "该小程序被申请次数已达今日限制"
89414 "每天仅允许申请50次半屏小程序"
89420 "不支持添加个人主体小程序"
89423 "申请次数添加到达上限"
89424 "授权次数到达上限"
89425 "申请添加已超时"
89426 "申请添加状态异常"
89427 "申请号和授权号相同"
89428 "该小程序已申请,不允许重复添加"
89429 "已到达同一小程序每日最多申请次数"
89430 "该小程序已设置自动拒绝申请"
89431 "不支持此类型小程序"
89432 "不是小程序"
89418 "添加半屏小程序每日申请次数失败"
89419 "添加半屏小程序每日授权次数失败"
其他错误码 请查看全局错误码