获取应用在企业内的可用范围

GET

/open-apis/application/v2/app/visibility

该接口用于查询应用在该企业内可以被使用的范围，只能被企业自建应用调用。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://open.feishu.cn/open-apis/application/v2/app/visibility?app_id=&user_page_token&user_page_size' \
--header 'Authorization;'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "departments": [
            {
                "id": "od-aa2c50a04769feefededb7a05b7525a8"
            },
            {
                "id": "od-bdb63e2f2a339191d6fe51a2deb85fc8"
            }
        ],
        "invisible_departments": [
            {
                "id": "od-d3079cfb6ed783b9bdc2e9eac04e85b4"
            },
            {
                "id": "od-e4723cd981b2455351e12df154fc2b72"
            }
        ],
        "users": [
            {
                "open_id": "ou_d317f090b7258ad0372aa53963cda70d",
                "user_id": "79affdge"
            },
            {
                "open_id": "ou_f0855b4d2a754a2116a0f723e95420ac",
                "user_id": "f11e4868"
            }
        ],
        "invisible_users": [
            {
                "open_id": "ou_42ebd86208405e7d4ba6fd36cece410a",
                "user_id": "4ea58f49"
            },
            {
                "open_id": "ou_13c1f5a014eb6d1da8c79ac3e7442829",
                "user_id": "cd8y5dl0"
            }
        ],
        "groups": [
            {
                "id": "96815a9cd9beg8g4"
            },
            {
                "id": "8abfd94b552g2g9c"
            }
        ],
        "invisible_groups": [
            {
                "id": "96815a9cd9beg8g4"
            },
            {
                "id": "8abfd94b552g2g9c"
            }
        ],
        "is_visible_to_all": 0,
        "has_more_users": 0,
        "user_page_token": "ou_42ebd86208405e7d4ba6fd36cece410a"
    }
}

请求参数

Query 参数

app_id

目标应用的 ID

必需

user_page_token

string

可选

分页拉取用户列表起始位置标示，不填表示从头开始

user_page_size

string

可选

本次拉取用户列表最大个数(最大值 1000 ，0 自动最大个数 )

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

返回响应

🟢200200 Success

application/json

Body

code

integer

必需

返回码，非 0 表示失败

msg

string

返回码的描述

必需

data

object

返回的业务信息

必需

departments

array [object {1}]

可用部门列表

必需

users

array [object {2}]

必需

可用用户列表（仅包含单独设置的用户，可用部门、用户组中的用户未展开）

is_visible_to_all

integer

必需

是否全员可见，1：是，0：否

has_more_users

integer

必需

是否还有更多可见用户，1：是，0：否

user_page_token

string

必需

拉取下一页用户列表时使用的 user_page_token

invisible_departments

array [object {1}]

禁用部门列表

必需

invisible_users

array [object {2}]

必需

禁用用户列表（仅包含单独设置的用户，可用部门、用户组中的用户未展开）

groups

array [object {1}]

可用用户组列表

必需

invisible_groups

array [object {1}]

禁用用户组列表

必需

修改于 2023-02-02 10:13:41

获取应用管理员管理范围

获取用户可用的应用