Skip to content

获取用户可用的应用

该接口用于查询用户可用的应用列表,只能被企业自建应用调用。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/application/v1/user/visible_apps
HTTP MethodGET
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用获取用户可用的应用

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token
Content-Typestring固定值:"application/json; charset=utf-8"

请求参数

参数类型必填说明
page_tokenstring分页起始位置标示,不填表示从头开始。
page_sizeint单页需求最大个数(最大 100),0 自动最大个数。
langstring优先展示的应用信息的语言版本。 - zh_cn:简体中文 - zh_hk:繁体中文(中国香港) - zh_tw:繁体中文(中国台湾) - en_us:英文 - ja_jp:日文 - ko_kr:韩语 - es_es:西班牙语 - pt-br:葡萄牙语(巴西) - th_th:泰语 - vi_vn:越南语 - id_id:印尼语
open_idstring目标用户 open_id。
user_idstring目标用户 user_id,与 open_id 至少给其中之一,user_id 优先于 open_id。

响应

响应体

参数说明
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_abilityPC客户端默认的应用功能,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://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://s1-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"
            },
            {
                "app_id": "cli_9cb844403dbb9108",
                "app_name": "问卷网",
                "app_scene_type": 1,
                "avatar_url": "https://s3-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"
            }
        ],
        "has_more": 1,
        "lang": "zh_cn",
        "page_size": 3,
        "page_token": "3",
        "total_count": 34
    },
    "msg": "success"
}

内容来源:飞书开放平台 · 自动爬取整理