
# 查询附件下载地址接口
#### 场景描述
调用该接口，查询指定知识附件的下载地址。
#### 接口方法
该接口仅支持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 系统配置类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0100.html#ZH-CN_TOPIC_0000002481113506)。 |
   
表2请求消息体参数说明 
| 序号 | 名称      | 参数类型   | 是否必选 | 默认值 | 说明                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|:---|:---|
| 1  | kngId   | String | True | 无   | 知识ID。 可根据[查询栏目接口](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0941.html#ZH-CN_TOPIC_0000002513073857)或[查询知识列表接口](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0942.html#ZH-CN_TOPIC_0000002513233853)接口获取coluKngId，即本接口所需的kngId。 |
| 2  | fileKey | String | True | 无   | 文件ID。 可根据[查询知识详情接口](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0940.html#ZH-CN_TOPIC_0000002481273962)获取指定知识（coluKngId）的adjId，即本接口所需的fileKey。                                                                                          |
   
#### 响应说明
当调用本接口响应失败，则返回相应的错误码信息，错误码响应数据结构请查看[表3]。
 表3响应消息体参数说明 
| 序号 | 名称          | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| 1  | resultCode  | String | 请求返回的结果码。取值范围： - 0为成功  - 1为失败   |
| 2  | description | String | 请求结果描述。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| 3  | data        | Object | 请求结果对象，参数说明详见[表4](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0942.html#ZH-CN_TOPIC_0000002513233853__zh-cn_topic_0000002509989959_zh-cn_topic_0000001365516833_table75971021263)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   
表4data对象参数说明 
| 序号 | 名称  | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| 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"
  }
  ```
  
 
