# 获取半屏小程序调用列表
调用本接口可以获取半屏小程序调用列表,使用过程中如遇到问题,可在开放平台服务商专区发帖交流。
说明:通过add_embedded接口添加半屏小程序后,可通过当前接口获取半屏小程序调用列表。
# 请求地址
GET https://api.weixin.qq.com/wxaapi/wxaembedded/get_list?access_token=ACCESS_TOKEN
# 请求参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | String | 是 | 第三方平台接口调用令牌authorizer_access_token |
start | number | 否 | query参数,分页起始值 ,默认值为0 |
num | number | 否 | query参数,一次拉取最大值,最大 1000,默认值为10 |
请求示例:
GET https://api.weixin.qq.com/wxaapi/wxaembedded/get_list?access_token=ACCESS_TOKEN&start=0&num=10
# 返回参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | number | 返回码 |
errmsg | string | 错误信息 |
wxa_embedded_list | Array.Object | 半屏小程序列表 |
# wxa_embedded_list 结构体
属性 | 类型 | 说明 |
---|---|---|
appid | string | 半屏小程序appid |
create_time | number | 添加时间 |
headimg | string | 头像url |
nickname | string | 半屏小程序昵称 |
reason | string | 申请理由 |
status | string | 申请状态 |
# 半屏小程序状态 status 的定义
值 | 说明 |
---|---|
1 | 待验证 |
2 | 已通过 |
3 | 已拒绝 |
4 | 已超时 |
5 | 已撤销 |
6 | 已取消授权 |
返回结果示例:
{
"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
}
]
}
# 返回码说明
返回码 | 说明 |
---|---|
-1 | 系统繁忙 |
0 | 成功 |
89408 | "半屏小程序系统错误" |
89409 | "获取半屏小程序列表参数错误" |
其他错误码 | 请查看全局错误码 |