Skip to content

获取词典分类

获取飞书词典当前分类。
飞书词典目前为二级分类体系,每个词条可添加多个二级分类,但选择的二级分类必须从属于不同的一级分类。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/lingo/v1/classifications
HTTP MethodGET
接口频率限制1000 次/分钟、50 次/秒
支持的应用类型custom
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可baike:entity 查看、创建、编辑、删除词典词条 baike:entity:exempt_review 创建、更新词典免审词条 baike:entity:readonly 查看词典词条

请求头

名称类型必填描述
Authorizationstringtenant_access_tokenuser_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token

查询参数

名称类型必填描述
page_sizeint分页大小
示例值:20
默认值20
数据校验规则
- 取值范围:1500
page_tokenstring分页标记,第一次请求不填,表示从头开始遍历;分页查询结果还有更多项时会同时返回新的 page_token,下次遍历可采用该 page_token 获取查询结果
示例值:408ecac018b2e3518db37275e812aad7bb8ad3e755fc886f322ac6c430ba
repo_idstring词库ID(不传默认范围为全员词库)
如以应用身份获取非全员词库中的分类,需要在“词库设置”页面添加应用;若以用户身份获取非全员词库中的分类,该用户需要拥有对应词库的可见权限。
示例值:7202510112396640276

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ itemsclassification\[\]分类
    └ idstring二级分类 ID
    └ namestring二级分类名称
    └ father_idstring对应一级分类 ID
    └ i18n_namesi18n_cls_name\[\]国际化分类名
      └ languageint语言类型
可选值有
- 1: 中文 - 2: 英文 - 3: 日文
      └ namestring分类名
  └ page_tokenstring分页标记,当 has_more 为 true 时,会同时返回新的 page_token,否则不返回 page_token
  └ has_moreboolean是否还有更多项

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "id": "7049606926****37761",
                "name": "行业术语",
                "father_id": "704960692***837777",
                "i18n_names": [
                    {
                        "language": 1,
                        "name": "词典分类"
                    }
                ]
            }
        ],
        "page_token": "408ecac018b2e3518db37275e812****bb8ad3e755fc886f322ac6c430ba",
        "has_more": false
    }
}

错误码

HTTP状态码错误码描述排查建议
4002250001invalid param参数错误,参考文档检查输入参数
5002250002network anomaly, please try again多数请求是服务超时,请重新请求,少数是服务异常请咨询客服

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