获取当前设置的推荐规则列表

GET

https://open.feishu.cn/open-apis/application/v6/app_recommend_rules

获取当前设置的推荐规则列表。

错误码

HTTP状态码	错误码	描述	排查建议
400	210500	page_token does not exist or has expired	请检查 page_token 是否合法，page_token 过期时间为 2h，若超过 2h 请重新获取
400	210501	invalid page_token	page_token 在应用间不互通，请检查该 page_token 是否由调用接口的应用获取到
400	210502	page_size out of range, should be between 1 and 50	请检查 page_size 范围是否在 [1, 50] 范围内

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://open.feishu.cn/open-apis/application/v6/app_recommend_rules?page_size=&page_token=new-e11ee058b4a8ed2881da11ac7e37c4fc&user_id_type=' \
--header 'Authorization;'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "rules": [
            {
                "id": "7137896480337641492",
                "name": "管理员小白的推荐规则",
                "status": "open",
                "visibility_info": {
                    "is_all": true,
                    "department_ids": [
                        "od-fef5204d44fa03fad66278cb8e8036e4"
                    ],
                    "user_ids": [
                        "ou_35101d538d5b3ad10a5f3480f4c27972"
                    ],
                    "group_ids": [
                        "7137608198773686291"
                    ]
                },
                "recommend_item_infos": [
                    {
                        "item_id": "7137896480337625108",
                        "item_type": "application",
                        "name": "审批",
                        "description": "审批应用的描述",
                        "link_url": "http://www.example.com",
                        "client_id": "cli_a274440757b8901c",
                        "icon_url": "https://internal-api-lark-file.feishu-boe.cn/static-resource/v1/v2_6150f3c3-ceee-453e-a1ae-7c11d7f13edj~?image_size=&cut_type=&quality=&format=&sticker_format=.webp",
                        "default_locale": "zh_cn",
                        "i18n_name": {
                            "zh_cn": "审批",
                            "zh_hk": "審批",
                            "zh_tw": "審批",
                            "en_us": "Approval",
                            "ja_jp": "承認"
                        }
                    }
                ],
                "distributed_recommend_item_infos": [
                    {
                        "item_id": "7137896480337625108",
                        "item_type": "application",
                        "name": "审批",
                        "description": "审批应用的描述",
                        "link_url": "http://www.example.com",
                        "client_id": "cli_a274440757b8901c",
                        "icon_url": "https://internal-api-lark-file.feishu-boe.cn/static-resource/v1/v2_6150f3c3-ceee-453e-a1ae-7c11d7f13edj~?image_size=&cut_type=&quality=&format=&sticker_format=.webp",
                        "default_locale": "zh_cn",
                        "i18n_name": {
                            "zh_cn": "审批",
                            "zh_hk": "審批",
                            "zh_tw": "審批",
                            "en_us": "Approval",
                            "ja_jp": "承認"
                        }
                    }
                ]
            }
        ],
        "page_token": "new-e11ee058b4a8ed2881da11ac7e37c4fc",
        "has_more": true
    }
}

请求参数

Query 参数

page_size

string

必需

分页大小

示例值：10

数据校验规则：

最大值：50

page_token

string

可选

分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果

示例值:

new-e11ee058b4a8ed2881da11ac7e37c4fc

user_id_type

string

可选

用户 ID 类型

示例值："open_id"

可选值有：

open_id：标识一个用户在某个应用中的身份。同一个用户在不同应用中的 Open ID 不同。了解更多：如何获取 Open ID
union_id：标识一个用户在某个应用开发商下的身份。同一用户在同一开发商下的应用中的 Union ID 是相同的，在不同开发商下的应用中的 Union ID 是不同的。通过 Union ID，应用开发商可以把同个用户在多个应用中的身份关联起来。了解更多：如何获取 Union ID？
user_id：标识一个用户在某个租户内的身份。同一个用户在租户 A 和租户 B 内的 User ID 是不同的。在同一个租户内，一个用户的 User ID 在所有应用（包括商店应用）中都保持一致。User ID 主要用于在不同的应用间打通用户数据。了解更多：如何获取 User ID？
默认值：open_id

当值为 user_id，字段权限要求：

获取用户 user ID

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

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

rules

array [object {6}]

推荐规则列表

必需

page_token

string

必需

分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token

has_more

boolean

是否还有更多项

必需

修改于 2023-02-07 08:46:39

获取妙记信息

获取企业信息

获取当前设置的推荐规则列表

错误码#

请求参数

返回响应

错误码