远程文件url上传

  • 接口：common/files/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.url String 远程文件url TRUE 无
data.file_name String 文件名 TRUE 无

返回参数

字段名称 字段类型 字段描述
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": [
        {
            "url": "https://cloudpense.com/files/test.pdf",
            "file_name": "test.pdf"
        },
        {
            "url": "https://cloudpense.com/files/test2.pdf",
            "file_name": "test2.pdf"
        }
    ]
}

返回数据

全部文件上传成功返回

{
    "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 ""