文档首页/ 云客服/ API参考/ 知识库管理类接口参考/ 接口说明/ 查询附件下载地址接口
更新时间：2026-07-31 GMT+08:00
查看PDF
分享

查询附件下载地址接口

场景描述

调用该接口，查询指定知识附件的下载地址。

接口方法

该接口仅支持POST方法。

接口URI

https://域名/apiaccess/ccikbs/v1/knowledge/download，例如域名是service.besclouds.com。

请求说明

表1 请求消息头参数说明

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定填 application/json;charset=UTF-8（两种鉴权方式都填写）。

2

x-app-key

string

True

appKey字段，用户标识，请联系运营人员获取appKey。

3

Authorization

String

True

鉴权信息， 格式如下所示。

Bearer Access Token。

Access Token的生成方式参见C1 系统配置类接口鉴权方式。
表2 请求消息体参数说明

序号

名称

参数类型

是否必选

默认值

说明

1

kngId

String

True

无

知识ID。

可根据查询栏目接口或查询知识列表接口接口获取coluKngId，即本接口所需的kngId。

2

fileKey

String

True

无

文件ID。

可根据查询知识详情接口获取指定知识（coluKngId）的adjId，即本接口所需的fileKey。

响应说明

当调用本接口响应失败，则返回相应的错误码信息，错误码响应数据结构请查看表3。

表3 响应消息体参数说明

序号

名称

参数类型

说明

1

resultCode

String

请求返回的结果码。取值范围：

  • 0为成功
  • 1为失败

2

description

String

请求结果描述。

3

data

Object

请求结果对象，参数说明详见表4
表4 data对象参数说明

序号

名称

参数类型

说明

1

url

String

当前知识附件obs下载地址。

说明：

iKBS附件在OBS/LSS中以随机名称附件保存，下载链接为OBS/LSS生成，直接下载OBS/LSS上保存的随机名称附件，下载后需要根据查询知识列表接口得出的kngAdj的值手动修改文件名与后缀。

报文样例

  • 请求头 
    x-app-key: b*************c7b
Authorization: Bearer 1fea*************1d6a15
Content-Type: application/json
  • 请求参数 
    {
    "fileKey": "1286999405181796356",
    "kngId": "1286999404577816579"
}
  • 响应参数 
    {
    "returnCode": "0",
    "description": "success",
    "url": "https://aicc-develop-lab.obs.cn-north-1.myhuaweicloud.com:443/ccikbs/file/202209065604/9bda03e5-a538-404a-b719-869575b56edd?AccessKeyId=22QW**********B0GF&Expires=1665650432&Signature=tQMT**********pE%3D"
}
父主题： 接口说明

相关文档