文档首页/ 云客服/ API参考/ 网页客户端接入/ 客户接收文件 (downloadFileStream)
更新时间：2024-09-24 GMT+08:00
查看PDF
分享

客户接收文件 (downloadFileStream)

场景描述

客户接收文件

接口方法

POST

接口URI

https://域名/apiaccess/ccmessaging/downloadFileStream，例如域名是service.besclouds.com

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

ccmessaging-token

string

True
  • applyToken接口返回的token值。
  • 会话过程中接口Response Header中返回的ccmessaging-token的值。

2

x-app-key

string

True

appKey字段，用户标识，在API Fabric工具上配置

3

Authorization

string

True

鉴权字段，内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken（Bearer后有空格）
表2 请求体参数

序号

名称

参数类型

是否必选

说明

1

reqBody

ReqBody

True

请求体
表3 ReqBody参数结构

序号

名称

参数类型

是否必选

说明

1.1

fileId

string

True

文件下载的fileId，在poll接口中携带

fileId取值 "local/" + content（poll接口响应）时，判定为发送本地文件。若不携带，则判定发送多媒体库文件。

1.2

channel

string

True

下载渠道类型，当前固定为WEB。

1.3

fileType

string

True

下载的文件类型，支持jpg，png，bpm，mp3，aac，mp4，txt，csv，richtext，doc，docx，pdf，zip。

发送本地文件场景下，该参数为多媒体文件下行消息中mediaFileType字段。

1.4

multiMedia

string

False

如果文件为多媒体库文件时，该参数必填，并且需要配置为“multiMedia”。

响应说明

  • 响应状态码: 200
    表4 RspBody参数结构

    序号

    名称

    参数类型

    说明

    1.1

    fileStream

    string

    Base64编码后的文件流。

    1.2

    resultCode

    string

    响应返回码，0表示成功，非0表示失败

    • 0：成功，不反悔提示信息
    • 401：objectKey is null!
    • 13：param filetype Out of range!或empty file!或fsservice downloadFile is failed或downloadFileStream IOException或downloadFileStream exception
    • 2：param channelId or userId or tenantId is null

    1.3

    resultDesc

    string

    响应返回描述，0表示成功，非0表示失败。

    1.4

    fileUrl

    string

    接收文件临时查看链接。默认保留24小时。
  • 响应状态码: 400

    错误的请求：请检查请求路径及参数。

  • 响应状态码: 401

    未授权：1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。

  • 响应状态码: 404

    请求的内容未找到：请检查请求的路径。

  • 响应状态码: 500

    业务失败：请依次确认您请求中各参数的取值。

错误码

无。

报文样例

  • 场景描述：客户接收座席发送的多媒体库文件

    请求参数:

    {
	"fileType": "jpg",
	"channel": "WEB",
	"fileId": "XXXXXXXXXXXXXXXX",
        "multiMedia":"multiMedia"
}

    响应参数:

    {
    "resultCode": "0",
    "fileUrl": "https://IP:PORT/ccmessaging/202307260369/agent/202307260369134944/1111111111114/e43f69a2-01ee-48ec-82cd-bdf8447492e0.png?AccessKeyId=5BKCLVUJC700HY9M51AT&Expires=1716445961&Signature=LDYl%2FfEpaLbpvlxfEnYxW8QdevY%3D",
    "fileStream": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsKCwsNDhIQDQ4RDgsLEBYQERMUFRUVDA8XGBYUGBIUFRT/2wBDAQMEBAUEBQkFBQkUDQsNFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBQUFBT/wAARCAA9ADwDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcI"
}
  • 场景描述：客户接收座席发送的本地文件

    请求参数:

    {
	"fileType": "png",
	"channel": "WEB",
	"fileId": "local/XXXXXXXXXXXXXXXX"
}

    响应参数:

    {
    "resultCode": "0",
    "fileUrl": "https://IP:PORT/ccmessaging/202307260369/agent/202307260369134944/1111111111114/e43f69a2-01ee-48ec-82cd-bdf8447492e0.png?AccessKeyId=5BKCLVUJC700HY9M51AT&Expires=1716445961&Signature=LDYl%2FfEpaLbpvlxfEnYxW8QdevY%3D",
    "fileStream": "iVBORw0KGgoAAAANSUhEUgAAACEAAAAnCAYAAACBvSFyAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAAA7SURBVFhH7c6hEQAgDAAx1uj+gxbB/QyYiPicmdnfJCIRiUhEIhKRiEQkIhGJSEQiEpGIRCQiEYln9gJ7uXthjovHaAAAAABJRU5ErkJggg=="
}
父主题： 网页客户端接入

相关文档