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

保存文档元数据

批量保存文档元数据,docMetaSimpleVOs 数量不能超过 100。spaceId 可不传,服务端将以 docId 所属空间为准;传入时必须一致。

请求体

名称类型必填描述示例值
spaceIdint64否知识库空间 ID;可不传,服务端以文档所属空间为准;传入时必须与文档所属空间一致。123456
docIdint64是文档 ID。987654
docMetaSimpleVOsobject[]是待保存的元数据列表,最多 100 个。
└metaIdint64否元数据 ID。123456
└metaValuestring否文本类型属性值;标签类型属性兼容单个标签 ID。产品文档
└metaValuesstring[]否标签类型属性的标签 ID 列表;空数组表示清空该属性标签。["123","456"]

返回参数

名称类型描述示例值
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/saveDocMetaInfos
POST
/api/athena/openApi/external/saveDocMetaInfos
curl -X POST "https://b.163.com/api/athena/openApi/external/saveDocMetaInfos" \  -H "Content-Type: application/json" \  -d '{    "docId": 987654,    "docMetaSimpleVOs": [      {}    ]  }'
{
  "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"
}

这篇文档有帮助吗?