获取全部知识库分类

该接口用于获取服务台知识库所有分类。

服务台请求Header中还需添加“服务台token”参数：

Key: X-Lark-Helpdesk-Authorization

Value: base64(helpdesk_id:helpdesk_token)，通过base64加密将helpdesk_id和helpdesk_token用':'连接而成的字符串。

错误码

HTTP状态码	错误码	描述	排查建议
401	154001	Unauthorized, please check you have the correct access	检查Authorization 和 X-Lark-Helpdesk-Authorization 是否正确，应用和服务台属于同一租户
500	155000	Internal error	内部错误，请联系我们

curl --location --request GET 'https://open.feishu.cn/open-apis/helpdesk/v1/categories?lang=zh_cn&order_by=1&asc=true' \ --header 'Authorization: Bearer {{tenant_access_token}}' \ --header 'Authorization;' \ --header 'X-Lark-Helpdesk-Authorization: Njk5NTM4NTU2NDMxNjg3NjgwMTpodC03NTQwZmNkYy1lZjkyLTM0NjUtYWY5Zi04OGJkY2E1Y2U3MDE='

{ "code": 0, "msg": "success", "data": { "categories": [ { "category_id": "6948728206392295444", "id": "6948728206392295444", "name": "创建团队和邀请成员", "parent_id": "0", "helpdesk_id": "6939771743531696147", "language": "zh_cn", "children": [ { "id": "4", "name": "Hardware", "parent_id": "6841014521893552132", "children": [ { "id": "5", "name": "Computer", "parent_id": "4", "helpdesk_id": "123456", "language": "en_us" } ], "helpdesk_id": "123456", "language": "en_us" } ] } ] } }

请求参数

Query 参数

lang

string

可选

知识库分类语言示例值："zh_cn"

示例值:

zh_cn

order_by

string

可选

排序键。1: 根据知识库分类更新时间排序示例值：1

示例值:

asc

string

可选

顺序。true: 正序；false：反序示例值：true

示例值:

true

Header 参数

Authorization

必需

tenant_access_token
值格式："Bearer access_token"
示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560"

示例值:

Bearer {{tenant_access_token}}

X-Lark-Helpdesk-Authorization

必需

鉴权，检查用户具有访问某一服务台信息的权限详见: 服务台token

示例值:

Njk5NTM4NTU2NDMxNjg3NjgwMTpodC03NTQwZmNkYy1lZjkyLTM0NjUtYWY5Zi04OGJkY2E1Y2U3MDE=

Content-Type

string

必需

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

默认值:

application/json; charset=utf-8

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

获取全部知识库分类

错误码#

请求参数

返回响应

错误码