# 获取企业安装的应用
该接口用于查询企业安装的应用列表，只能被企业自建应用调用。
该接口为旧版获取企业安装应用接口。推荐使用新版接口[获取企业安装的应用](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/application-v6/application/list)。
## 请求
基本 |
---|---
HTTP URL | https://open.feishu.cn/open-apis/application/v3/app/list
HTTP Method | GET
支持的应用类型 | Custom App
权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 获取应用信息(admin:app.info:readonly)
### 请求头
名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"
### 请求参数
|参数|类型|必须|说明|来源|
|--|-----|--|----|----|
|page_token|string|否|分页起始位置标示，不填表示从头开始（不保证 page_token 一定为数字，请填入上一次请求返回的 page_token）|请求 URL|
|page_size|int|否|单页需求最大个数（最大 100），0 自动最大个数|请求 URL|
|lang|string|否|优先展示的应用信息的语言版本（zh_cn：中文，en_us：英文，ja_jp：日文）|请求 URL|
|status|int|否|要返回的应用的状态，0:停用；1:启用；-1:全部，默认为 -1|请求 URL|
## 响应
### 响应体
|参数|说明|
|--|--|
|code|返回码，非 0 表示失败|
|msg|返回码的描述|
|data|返回的业务信息，仅 code = 0 时有效|
| ∟page_token|下一个请求页应当给的起始位置|
| ∟page_size|本次请求实际返回的页大小|
| ∟total_count|可用的应用总数|
| ∟has_more|是否还有更多应用|
| ∟lang|当前选择的版本语言|
| ∟app_list|应用列表|
| ∟app_id|应用 ID|
| ∟primary_language|应用首选语言|
| ∟app_name|应用名称|
| ∟description|应用描述|
| ∟avatar_url|应用 icon|
| ∟app_scene_type|应用类型，0：企业自建应用；1：应用商店应用|
| ∟status|启停状态，0：停用；1：启用|
| ∟mobile_default_ability|移动端默认的应用功能，0：未开启；1：小程序；2：H5；8：机器人|
| ∟pc_default_ability|PC客户端默认的应用功能，0：未开启；1：小程序；2：H5；8：机器人|
| ∟create_source|应用创建来源：`developer_console`：开发者后台；`base`：多维表格自动化流程创建的应用；`app_engine`：飞书应用引擎；`bot_builder`：机器人助手；`aily`：aily(智能伙伴搭建平台)；`unknown`：未知来源|
### 响应示例
```json
{
"code": 0,
"data": {
"app_list": [
{
"app_id": "cli_9cb844403dbb9108",
"app_name": "问卷网",
"app_scene_type": 1,
"avatar_url": "https://s1-imfile.feishucdn.com/static-resource/v1/d5ca5971-437b-4b1d-b295-679268f9a2cg",
"description": "专业易用的「问卷调研 · 报名表单 · 考试测评」平台",
"mobile_default_ability": 1,
"pc_default_ability": 1,
"primary_language": "zh_cn",
"status": 1,
"create_source": "developer_console"
},
{
"app_id": "cli_9cb844403dbb9108",
"app_name": "审批",
"app_scene_type": 1,
"avatar_url": "https://s3-imfile.feishucdn.com/static-resource/v1/e37af67a-b012-4ee0-80ea-a4d28c94b4eg",
"description": "简单、高效、开放的审批工具",
"mobile_default_ability": 1,
"pc_default_ability": 1,
"primary_language": "zh_cn",
"status": 1,
"create_source": "developer_console"
},
{
"app_id": "cli_9cb844403dbb9108",
"app_name": "工资单",
"app_scene_type": 1,
"avatar_url": "https://s3-imfile.feishucdn.com/static-resource/v1/da710014fc4c975ce66b~?image_size=noop&cut_type=&quality=_q100&format=image&sticker_format=.webp",
"description": "便捷、安全的工资单管理，一键完成工资发布",
"mobile_default_ability": 1,
"pc_default_ability": 1,
"primary_language": "zh_cn",
"status": 1,
"create_source": "developer_console"
}
],
"has_more": 1,
"lang": "zh_cn",
"page_size": 3,
"page_token": "3",
"total_count": 34
},
"msg": "success"
}
```