获取全部知识库分类

GET

/open-apis/helpdesk/v1/categories

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

服务台请求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	内部错误，请联系我们

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Query 参数

Header 参数

返回响应

🟢200200 Success

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET '/open-apis/helpdesk/v1/categories?lang=zh_cn&order_by=1&asc=true' \
--header 'X-Lark-Helpdesk-Authorization: Njk5NTM4NTU2NDMxNjg3NjgwMTpodC03NTQwZmNkYy1lZjkyLTM0NjUtYWY5Zi04OGJkY2E1Y2U3MDE=' \
--header 'Authorization: Bearer <token>'

响应示例

{
    "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"
                    }
                ]
            }
        ]
    }
}

修改于 2023-02-02 07:19:17

删除知识库分类详情

推送审核通知事件

获取全部知识库分类

错误码#

请求参数

返回响应

错误码