补全当前用户有权访问的业务关键词

从 yiask_learned 搜索关键词候选，并根据当前用户的空间、模型、字段和行级权限过滤结果。

传入 dataFilter 时，服务端不会复制或读取完整底表记录，而是根据 learned 结果中的 schema + field 自动分组，将候选分批回查底表，仅保留满足底表条件的候选值。可以分别在 filter.schema 和 filter.field 下使用 $in 提前缩小搜索范围，但不是必填。指标及没有来源字段的关键词不会返回。

不传 dataFilter 时使用普通分页：page 从 1 开始，并返回精确的 count 和 totalPage。传入 dataFilter 时使用游标分页：首次请求不传 cursor，后续请求保持其他条件不变并传入上次响应的 nextCursor。游标模式返回 hasNext，不计算精确总数。

游标模式每批最多扫描 500 个 learned 候选并回查底表，持续扫描直到填满当前页或达到单次 10,000 个候选的扫描上限。达到扫描上限时可通过 nextCursor 在下一请求继续，不会把全部候选加载到内存。pageSize 默认为 20，最大为 50。sort 使用 NocoBase 排序格式，字段名前的 - 表示降序。

curl 示例：筛选生产部员工名称

curl 示例：继续读取下一页

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

不回查底表的普通补全按底表部门筛选员工名称

{
    "keyword": "销售",
    "page": 1,
    "pageSize": 10
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

普通分页或底表过滤游标分页结果

Bodyapplication/json

示例

{
    "pageSize": 20,
    "hasNext": true,
    "nextCursor": "eyJ2ZXJzaW9uIjoxLCJvZmZzZXQiOjUwMCwiZmluZ2VycHJpbnQiOiIuLi4ifQ",
    "data": [
        {
            "value": "张三",
            "type": "dimension",
            "schema": "employees",
            "field": "名称"
        }
    ]
}

🟠400