获取应用信息列表
查看文档来源信息
- 来源目录:
addons/sys_base/docs - 来源文件:
接口文档/63-获取应用信息列表.md
详细说明
用于读取当前模块下的应用信息列表,供应用信息页、角色应用绑定和应用菜单治理页选择正式应用实例时复用。
接口信息
| 项目 | 内容 |
|---|---|
| 请求方式 | GET |
| 请求路径 | /sys_base/platform/wechatAppsInfo/getWechatAppsInfoList |
| 来源文件 | 接口文档/63-获取应用信息列表.md |
请求头
| 请求头 | 示例值 | 说明 |
|---|---|---|
x-token | <jwt-token> | 登录令牌。 |
app-id | mid-admin | 当前应用 ID。 |
addons-type | sys_base | 当前模块标识。 |
入参
本接口无请求体参数。
参数说明
- 传入
addonsType时,后端会先查询该模块对应的app_model.id集合,再按app_wechat_apps_info.addons_id命中这些模块 ID 进行正式过滤。 - 正式模块归属以模块关联关系为准,而不是只看
app_wechat_apps_info.addons_type。 - 该过滤结果与角色应用绑定保存使用同一套模块判定口径。
- 列表接口只返回应用展示、选择和绑定需要的非密钥字段;
appSecret、mchSecret、mchSecretV3仅可能返回固定掩码或空值,不返回真实 secret。因此仅查看列表、角色绑定或应用菜单范围选择时,不需要任何 secret 解密配置。
请求示例
当前文档未提供独立请求示例,请参考下方 curl 示例。
响应输出
json
{
"code": 0,
"msg": "获取成功",
"data": {
"list": [
{
"uuid": "0031766249093132337",
"wechatName": "系统管理端",
"appid": "mid-admin",
"addonsType": "take_away",
"addonsId": "672"
}
],
"total": 1,
"page": 1,
"pageSize": 20
}
}字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
data.list | array | 应用实例列表 |
data.list[].uuid | string | 应用实例 UUID |
data.list[].wechatName | string | 应用名称 |
data.list[].appid | string | 应用 ID |
data.list[].addonsType | string | 应用记录自带的模块标识,正式归属仍需结合 addonsId 判断 |
data.list[].addonsId | string | 关联的模块 ID 集合 |
data.list[].appSecret | string | 密钥存在时固定返回 ******,无密钥时为空;不得作为运行密钥使用 |
data.list[].mchSecret | string | 密钥存在时固定返回 ******,无密钥时为空;不得作为运行密钥使用 |
data.list[].mchSecretV3 | string | 密钥存在时固定返回 ******,无密钥时为空;不得作为运行密钥使用 |
data.total | number | 总条数 |
curl 示例
bash
curl --location --request GET 'http://127.0.0.1:8100/sys_base/platform/wechatAppsInfo/getWechatAppsInfoList?page=1&pageSize=20&addonsType=sys_base' \
--header 'x-token: <jwt-token>' \
--header 'app-id: mid-admin' \
--header 'addons-type: sys_base'