远程文件url上传

  • 接口：common/files/v2/remote
  • Method：POST
  • 数据格式：JSON
  • 限流信息：每小时1000次
  • 多语言环境：在接口请求头中添加Key为locale,Value值为语言环境,目前支持的语言有zh_CN(中文)、en_US(英文)、ja_JP(日文)、zh_TW( 繁体),请选取其中一种
  • 接口说明：通过远程文件地址直接上传到云服务器，支持指定文件下载时是否预览。
  • 其他补充信息：本接口为批量接口，接口返回成功不代表全部处理成功。具体参见示例

参数:

请求参数

字段名称 字段类型 字段描述 是否必填 长度限制(字节)
bizId String 当前次接口同步的唯一标识 TRUE 36
timestamp long 当前次接口同步时间对应的时间戳 TRUE 13
data Array 远程文件url数组 TRUE 数组长度不超过10
data.file_url String 远程文件url TRUE 无
data.file_name String 文件名 TRUE 无
data.preview_flag Boolean 文件是否预览。 true-预览 false-不预览直接下载,默认false FALSE 无

返回参数

字段名称 字段类型 字段描述
resCode Integer 响应状态码（见附录）
resMsg String 返回信息描述
data.attachment Array 上传成功信息
data.attachment[].fileURL String 远程文件url
data.attachment[].attachmentURL String 上传成功后文件地址
data.attachment[].fileName String 文件名
data.upload_errors Array 上传失败信息
data.upload_errors[].fileURL String 远程文件url
data.upload_errors[].messages String 上传失败原因

示例：

请求数据

{
  "bizId": "xxx",
  "timestamp": 4432434234234,
  "data": [
    {
      "file_url": "https://cloudpense.com/files/test.pdf",
      "file_name": "test.pdf",
      "preview_flag": true
    },
    {
      "file_url": "https://cloudpense.com/files/test2.pdf",
      "file_name": "test2.pdf",
      "preview_flag": false
    }
  ]
}

返回数据

全部文件上传成功返回

{
  "resCode": 200000,
  "resMsg": "success",
  "data": {
    "attachment": [
      {
        "fileURL": "https://cloudpense.com/files/test.pdf",
        "attachmentURL": "out/2020/07-21/7624b85e-f608-4a29-88b9-8551edfbc6f1.pdf",
        "fileName": "test.pdf"
      },
      {
        "fileURL": "https://cloudpense.com/files/test2.pdf",
        "attachmentURL": "out/2020/07-21/34kfnb9i-f608-4a29-88b9-8551edfbc6f.pdf",
        "fileName": "test2.pdf"
      }
    ]
  }
}

部分文件上传成功返回

{
  "resCode": 200000,
  "resMsg": "success",
  "data": {
    "attachment": [
      {
        "fileURL": "https://xxxxx.s3.cn-northre=12c32fa2e518cd3c106323155",
        "attachmentURL": "out/2020/07-21/7624b85e-f608-4a29-88b9-8551edfbc6f1.pdf",
        "fileName": "test.pdf"
      }
    ],
    "upload_errors": [
      {
        "fileURL": "https://xxxxx.s3.cn-northre=3232432",
        "messages": [
          "服务器异常，请稍后再试"
        ]
      }
    ]
  }
}

全部文件上传失败返回

{
  "resCode": 200000,
  "resMsg": "success",
  "data": {
    "upload_errors": [
      {
        "fileURL": "https://cloudpense.com/files/test.pdf",
        "messages": [
          "附件上传失败"
        ]
      },
      {
        "fileURL": "https://cloudpense.com/files/test2.pdf",
        "messages": [
          "服务器异常，请稍后再试"
        ]
      }
    ]
  }
}

results matching ""

    No results matching ""