# 创建知识库
该接口用于创建知识库。
## 请求
基本 |
---|---
HTTP URL | https://open.larksuite.com/open-apis/helpdesk/v1/faqs
HTTP Method | POST
权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 更新服务台资源详情
### 请求头
名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `user_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer u-7f1bcd13fc57d46bac21793a18e560"
[了解更多：获取与使用access_token](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"
**注意事项**：服务台请求Header中还需添加“服务台token”参数：
Key: X-Lark-Helpdesk-Authorization
Value: base64(helpdesk_id:helpdesk_token)，通过base64加密将helpdesk_id和helpdesk_token用':'连接而成的字符串。
[了解更多：获取与使用服务台token](https://open.larksuite.com/document/ukTMukTMukTM/ugDOyYjL4gjM24CO4IjN)
### 请求体
名称 | 类型 | 必填 | 描述
---|---|---|---
faq | faq_update_info | 否 | 知识库详情
∟ category_id | string | 否 | 知识库分类ID
**示例值**："6836004780707807251"
∟ question | string | 是 | 问题
**示例值**："问题"
∟ answer | string | 否 | 答案
**示例值**："答案"
∟ answer_richtext | string | 否 | 富文本答案和答案必须有一个必填。Json Array格式，富文本结构请见[了解更多: 富文本](https://open.larksuite.com/document/ukTMukTMukTM/uITM0YjLyEDN24iMxQjN)
**示例值**："[{
"content": "这只是一个测试，医保问题",
"type": "text"
}]"
∟ tags | string\[\] | 否 | 关联词
### 请求体示例
```json
{
"faq": {
"category_id": "6836004780707807251",
"question": "问题",
"answer": "答案",
"answer_richtext": "[{
"content": "这只是一个测试，医保问题",
"type": "text"
}]",
"tags": [
"关联词"
]
}
}
```
## 响应
### 响应体
名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
∟ faq | faq | 知识库详情
∟ faq_id | string | 知识库ID
∟ id | string | 知识库旧版ID，请使用faq_id
∟ helpdesk_id | string | 服务台ID
∟ question | string | 问题
∟ answer | string | 答案
∟ answer_richtext | string | 富文本答案
∟ create_time | int | 创建时间
∟ update_time | int | 修改时间
∟ categories | category\[\] | 分类
∟ category_id | string | 知识库分类ID
∟ id | string | 知识库分类ID，（旧版，请使用category_id）
∟ name | string | 名称
∟ parent_id | string | 父知识库分类ID
∟ helpdesk_id | string | 服务台ID
∟ language | string | 语言
∟ tags | string\[\] | 关联词列表
∟ expire_time | int | 失效时间
∟ update_user | ticket_user | 更新用户
∟ id | string | 用户ID
∟ avatar_url | string | 用户头像url
∟ name | string | 用户名
∟ create_user | ticket_user | 创建用户
∟ id | string | 用户ID
∟ avatar_url | string | 用户头像url
∟ name | string | 用户名
### 响应体示例
```json
{
"code": 0,
"msg": "success",
"data": {
"faq": {
"faq_id": "6936004780707807231",
"id": "6936004780707807231",
"helpdesk_id": "6936004780707807251",
"question": "问题",
"answer": "答案",
"answer_richtext": "{
"content": "这只是一个测试，医保问题",
"type": "text"
}",
"create_time": 1596379008,
"update_time": 1596379008,
"categories": [
{
"category_id": "6948728206392295444",
"id": "6948728206392295444",
"name": "创建团队和邀请成员",
"parent_id": "0",
"helpdesk_id": "6939771743531696147",
"language": "zh_cn"
}
],
"tags": [
"关联词1"
],
"expire_time": 1596379008,
"update_user": {
"id": "ou_37019b7c830210acd88fdce886e25c71",
"avatar_url": "https://xxxx",
"name": "abc"
},
"create_user": {
"id": "ou_37019b7c830210acd88fdce886e25c71",
"avatar_url": "https://xxxx",
"name": "abc"
}
}
}
}
```
### 错误码
HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
400 | 154000 | Bad request, please check your request body | 请求不合法，请检查参数
500 | 155000 | Internal error | 内部错误，请联系我们