# 获取半屏小程序调用列表

调试工具

接口应在服务器端调用，详细说明参见服务端API。

# 接口说明

# 接口英文名

getEmbeddedList

# 功能描述

调用本接口可以获取半屏小程序调用列表，使用过程中如遇到问题，可在开放平台服务商专区发帖交流。
说明，通过addEmbedded接口添加半屏小程序后，可通过当前接口获取半屏小程序调用列表。

# 调用方式

# HTTPS 调用


GET https://api.weixin.qq.com/wxaapi/wxaembedded/get_list?access_token=ACCESS_TOKEN

# 第三方调用

调用方式以及出入参和HTTPS相同，仅是调用的token不同
该接口所属的权限集id为：18
服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证，该参数为 URL 参数，非 Body 参数。使用authorizer_access_token
start	number	否	query参数，分页起始值，默认值为0
num	number	否	query参数，一次拉取最大值，最大 1000，默认值为10

# 返回参数

属性

类型

说明

errcode

number

错误码

errmsg

string

错误信息

wxa_embedded_list

array<object>

半屏小程序列表

属性	类型	说明
appid	string	半屏小程序appid
create_time	number	添加时间
headimg	string	头像url
nickname	string	半屏小程序昵称
reason	string	申请理由
status	string	申请状态

embedded_flag

number

授权方式。0表示需要管理员确认，1表示自动通过，2表示自动拒绝

# 其他说明

# 半屏小程序申请状态 status 的枚举值

值	说明
1	待验证
2	已通过
3	已拒绝
4	已超时
5	已撤销
6	已取消授权

# 调用示例

示例说明: HTTPS请求

# 请求数据示例


GET https://api.weixin.qq.com/wxaapi/wxaembedded/get_list?access_token=ACCESS_TOKEN&start=0&num=10

# 返回数据示例


{
    "errmsg": "ok",
    "errcode": 0,
    "wxa_embedded_list": [
        {
            "appid": "wxf074afxxxxxxxx",
            "create_time": 1648177830,
            "headimg": "http://wx.qlogo.cn/mmhead/Q3axxxxxxxdRLA",
            "name": "testxxx6",
            "nickname": "tesxxx",
            "reason": "我是理由",
            "status": 1
        },
        {
            "appid": "wx355c73xxxxxxx",
            "create_time": 1647250557,
            "headimg": "http://wx.qlogo.cn/mmhead/QxxxxxxA",
            "name": "深圳市xx计算机系统有限公司",
            "nickname": "美味助手xx",
            "reason": "特殊",
            "status": 2
        }
    ]
}

# 错误码

错误码	错误码取值	解决方案
89408	半屏小程序系统错误
89409	获取半屏小程序列表参数错误
40001	invalid credential access_token isinvalid or not latest	access_token 无效或不为最新获取的 access_token，请开发者确认access_token的有效性