# 获取半屏小程序调用列表
调用本接口可以获取半屏小程序调用列表,使用过程中如遇到问题,可在开放平台服务商专区发帖交流。
说明:通过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 | "获取半屏小程序列表参数错误" |
| 其他错误码 | 请查看全局错误码 |