LabelCommonUpdate-更新知识标签
更新时间:2026-01-22
API访问域名
| 请求方式 | POST |
|---|---|
| base url | https://keyue.cloud.baidu.com |
| 后缀接口 | open/v1/api/knowledge/label/common/update |
| Authentication | token为API Key |
说明
该接口用于更新知识标签
请求参数
Header参数
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| Content-Type | string | 是 | 内容类型 | 固定值:application/json |
| AgentId | string | 是 | 机器人id | 进入机器人后可在URL中查看和获取 |
| tenantId | string | 是 | 租户id | 进入机器人后可在URL中查看和获取 |
| token | string | 是 | API KEY | 机器人API KEY。 详细获取方式参考:准备工作 |
| uid | string | 是 | 用户ID | 详细获取方式参考:准备工作 |
| username | string | 是 | 用户名 | 详细获取方式参考:准备工作 |
Param参数
无
Body参数
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| id | string | 是 | 知识标签ID | |
| name | string | 是 | 知识标签名称 | |
| updateList | list | 是 | 更新的知识标签值列表 | 详见updateList子数据 |
| addList | list[string] | 是 | 新增的知识标签值列表 | |
| deleteList | list[string] | 是 | 删除的知识标签值id列表 |
updateList子数据
| 名称 | 类型 | 必选 | 中文名 | 说明 |
|---|---|---|---|---|
| id | string | 是 | 标签值id | |
| name | string | 是 | 标签值名称 | |
| tenantId | string | 否 | 租户id | |
| knowledgeLabelId | string | 否 | 标签id | |
| created | string | 否 | 创建时间 | |
| updated | string | 否 | 最近一次更新时间 |
响应参数
| 名称 | 类型 | 必填 | 中文名 | 说明 |
|---|---|---|---|---|
| time | integer | 是 | 时间 | 1717036810964 |
| data | object | 是 | 数据 | 更新成功data返回为空 |
| code | integer | 是 | 状态码 | 200 |
| msg | string | 是 | 状态信息 | OK |
请求示例
JSON
1 curl -X POST "https://keyue.cloud.baidu.com/open/v1/api/knowledge/label/common/update" \
2 --header "token:xxxx " \
3 --header "Content-Type: application/json" \
4 --header 'uid: xxxx' \
5 --header 'username:xxxx' \
6 --header 'tenantId:xxxx ' \
7 -d '{
8 "id": "label_123",
9 "name": "更新后的标签名称",
10 "updateList": [
11 {
12 "id": "value_id_1",
13 "name": "更新后的值1"
14 }
15 ],
16 "addList": [
17 {
18 "id": "new_value_id_1",
19 "name": "新增的值1"
20 }
21 ],
22 "deleteList": ["value_id_to_delete"]
23 }'
响应示例
1{
2 "time":1746932074480,
3 "data":null,
4 "code":200,
5 "msg":"OK"
6}
1
