Skip to content

获取词典分类

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

Error: 为了更好地提升接口文档的的易理解性,我们对文档进行了升级,请尽快迁移至新版本>>

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/baike/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 获取查询结果
示例值:408ecac018b2e3518db37275e812****bb8ad3e755fc886f322ac6c430ba

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ itemsclassification\[\]分类
    └ idstring二级分类 ID
    └ namestring二级分类名称
    └ father_idstring对应一级分类 ID
  └ page_tokenstring分页标记,当 has_more 为 true 时,会同时返回新的 page_token,否则不返回 page_token

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "id": "7049606926****37761",
                "name": "行业术语",
                "father_id": "7049606926****37777"
            }
        ],
        "page_token": "408ecac018b2e3518db37275e812****bb8ad3e755fc886f322ac6c430ba"
    }
}

错误码

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

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