文件操作

为了方便业务系统把相关的文件上传到U聊系统，u聊开放了文件上传下载的接口。

api详情

文件上传接口

接入系统消息将文件数据传送到U聊服务器，以便后续发送文件消息，或者富文本消息时引用。

• 提供方：U聊服务端
• 发起方：接入系统
• 接口路径：/upchat-public-gateway/api/app/upload
• 调用方式：HTTP POST
• 请求格式：multipart/form-data
• 请求编码：UTF-8
• 表单字段：
  1. apikey：消息发送凭据
  2. uploadtype：文件类型：
     • image-图片;
     • audio-音频;
     • video-视频（客户端暂不支持）
     • excel-excel文件
     • word-word文件
     • ppt-powerpoint文件
     • pdf-pdf文件
  3. files：多个文件数据数组
• 应答格式：application/json;charset=UTF-8
• 应答编码：UTF-8
• 应答数据：
  1. status：应答码，0表示成功，非0时异常信息见msg
  2. msg：异常信息；
  3. files：文件id数组

• 应答实例

    {    "status":"0",
        "msg":"成功",
        "files":[
            {"fileid":"000000004691712x014691f9c084000a", key:"xxxxxx"},
            {"fileid":"0000000042911a63014691f9c084000a", key:"xxxxxx"},
            {"fileid":"00000000429141a3014691f9c083000a", key:"xxxxxx"}
        ]
    }
  

文件下载接口

接入系统消息将文件fileid传送到U聊服务器，下载u聊服务器上的文件。

• 提供方：U聊服务端
• 发起方：接入系统
• 接口路径：/upchat-public-gateway/api/app/file/{fileid}
• 调用方式：HTTP POST
• 请求格式：application/x-www-form-urlencoded;charset=utf-8
• 请求编码：UTF-8
• 请求参数：
  1. fileid 文件标识
  2. apikey 登陆标识
  3. filesize 文件尺寸 1-min, 2-中图，3-其他， 原图
• 应答格式：application/json;charset=UTF-8
• 应答编码：UTF-8
• 应答数据：
  1. resp：文件数据http应答