获取企业安装的应用

该接口用于查询企业安装的应用列表，只能被企业自建应用调用。

Note 该接口为旧版获取企业安装应用接口。推荐使用新版接口获取企业安装的应用。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/application/v3/app/list
HTTP Method	GET
支持的应用类型	custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用	admin:app.info:readonly 获取应用信息

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
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：未知来源

响应示例

{
    "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"
}