知识库上传文件

curl -X POST 'https://HOST:PORT/api/v1/third_interface/knowledge/upload'

鉴权

出于安全考虑,必须将 TOKEN 存储于服务端并通过后端接口调用,避免在前端代码中直接暴露,以防止凭证泄露造成损失

请在 HTTP 请求的 Authorization 请求头中包含您的 TOKEN,格式如下:

Authorization: Bearer {YOUR_TOKEN}

TOKEN获取可通过 个人令牌 和 OAuth 应用获取,具体见 个人令牌授权OAuth 授权码授权

应用秘钥private_key 的获取具体见 生成应用密钥

Form-Data

  • knowledge_id (int): 知识库id
  • file (file): 单个附件

Response

  • status_code (int): 状态码,200表示成功
  • status_message (string): 状态信息
  • data (dict): 返回的数据
    • file_path (string): 文件地址

    • object_name (string): 文件对象名

    • status: (int): 文件状态 0新增文件 1已存在的文件

    • file_id: (int): 已存在的文件ID

    • name: (string): 已存在的文件名

响应示例

{
  "status_code": 200,
  "status_message": "SUCCESS",
  "data": {
    "file_path": "http://Host:PORT/tmp-dir/1_776/63b3fe52-30db-443a-8c70-17c2b22cdde5.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=minioroot%2F20250820%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20250820T034802Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&X-Amz-Signature=0eed1d514a99fbd9792b7e6566beb46f9747d21889772402c77d63afa053eb15",
    "object_name": "半云科技员工绩效考核管理办法.pdf",
    "status": 0,
    "file_id": null,
    "name": ""
  }
}