七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
知识库知识库外部开放接口

批量追加文档标签

向指定空间的多篇文档追加标签。标签已关联到其他属性时,将按既有规则迁移到指定属性;docIds 最多 100 条,labelIds 最多 10 条。

请求体

名称类型必填描述示例值
spaceIdint64是知识库空间 ID。123456
metaIdint64是标签类型属性 ID。234567
docIdsint64[]是待追加标签的文档 ID 列表,最多 100 条。[987654,987655]
labelIdsint64[]是待追加的标签 ID 列表,最多 10 条。[345678,345679]

返回参数

名称类型描述示例值
codeint32业务响应码。200 表示成功;失败时为 RetCode 中定义的业务码。200
msgstring响应说明。成功通常为 ok;失败时为错误原因。ok
messagestring兼容字段,部分异常场景可能返回错误说明。
dataint64资源 ID。987654

错误码

状态码描述
400请求参数错误。常见业务码:402 MISS_PARAM、403 ERR_PARAM。
401OPENAPI_AUTH 鉴权失败。常见业务码:405 AUTH_FAILED。
404资源不存在。常见业务码:404 NOT_FOUND、408 SPACE_NOT_EXISTS。
500服务内部异常。常见业务码:500 ERROR。
postEndpoint
/api/athena/openApi/external/batchAddLabels
POST
/api/athena/openApi/external/batchAddLabels
curl -X POST "https://b.163.com/api/athena/openApi/external/batchAddLabels" \  -H "Content-Type: application/json" \  -d '{    "spaceId": 123456,    "metaId": 234567,    "docIds": [      987654,      987655    ],    "labelIds": [      345678,      345679    ]  }'
{
  "code": 200,
  "msg": "ok",
  "message": "string",
  "data": 987654
}
{
  "code": 200,
  "msg": "ok",
  "message": "string"
}
{
  "code": 200,
  "msg": "ok",
  "message": "string"
}
{
  "code": 200,
  "msg": "ok",
  "message": "string"
}
{
  "code": 200,
  "msg": "ok",
  "message": "string"
}

这篇文档有帮助吗?