文档首页/ 云客服/ API参考/ 知识库管理/ 接口说明/ 查询附件下载地址接口
更新时间:2023-09-27 GMT+08:00

查询附件下载地址接口

场景描述

调用该接口,查询附件下载地址。

接口方法

该接口仅支持POST方法。

接口URI

SIA鉴权:https://ip:port/rest/ccikbs/v1/knowledge/download

AKSK鉴权:https://ip:port/rest/ccikbs/v1/knowledge/downloadByAKSK

其中,ip、port为NSLB服务器机机接口接入地址。

请求说明

表1 请求消息头参数说明

序号

名称

参数类型

是否必选

默认值

说明

1

Content-Type

String

True

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

2

X-TenantSpaceID

String

True

租户id(SIA鉴权填写)。

3

X-Access-Token

String

True

生成方式参见SIA鉴权(SIA鉴权填写)。

4

Authorization

String

True

生成方式参见知识库类接口鉴权方式(AKSK鉴权填写)。

表2 请求消息体参数说明

序号

名称

参数类型

是否必选

默认值

说明

1

kngId

String

True

知识id。参数值为APPCube数据库的数据表中的AICC_kngId_CST字段值,具体数据表根据知识状态查询AICC__Ikbs_Kngadjedit__CST、AICC__Ikbs_Columnknghis__CST或者AICC__Ikbs_Kngadjpre__CST表。

2

fileKey

String

True

文件id。参数值为APPCube数据库的数据表中的AICC_adjKey_CST字段值,具体数据表根据知识状态查询AICC__Ikbs_Kngadjedit__CST、AICC__Ikbs_Columnknghis__CST或者AICC__Ikbs_Kngadjpre__CST表。

3

ccId

Number

False

呼叫中心id。AKSK鉴权必填。

4

vdn

Number

False

vdnId。AKSK鉴权必填。

响应说明

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

表3 响应消息体参数说明

序号

名称

参数类型

说明

1

resultCode

String

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

  • 0为成功
  • 1为失败

2

description

String

请求结果描述。

3

data

Object

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

表4 data对象参数说明

序号

名称

参数类型

说明

1

url

String

当前知识附件obs下载地址

报文样例

  • 请求头
    Content-Type: application/json;charset=UTF-8
    X-TenantSpaceID:********
    Authorization: ******************
  • 请求参数
    {
        "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"
    }