指定文本url方式上传 API

请求URL

PUT https://apigate.glodon.com/iqcad/file/upload

说明

如果需要上传的文件不在本地,且该文件可以通过指定的HTTP URL可以下载,支持直接传一个外部的HTTP文件URL, 后台会去下载该文件,而无须用户先下载,再上传

请求参数

类别 名称 说明 类型
Header Authorization 必填 bearer {accessToken} string
Query etag 可选 文件etag string
Query name 必填 文件的全名,使用URL编码(UTF-8),最多256个字符 string
Query sourceId 可选 调用方的文件源ID,不能重复 string
Query url 必填 文件所在url string

响应

HTTP代码 说明 类型
200 OK GeneralResponse«FileBean»
201 Created 无内容
401 Unauthorized 无内容
403 Forbidden 无内容
404 Not Found 无内容

HTTP 请求示例

请求 path

https://apigate.glodon.com/iqcad/file/upload?name=example.dwg&url=http(s)://xxxxxxxxxxx

请求 header

"Authorization: Bearer dc671840-bacc-4dc5-a134-97c1918d664b"

请求成功数据说明

名称 说明 类型
createTime 可选 样例 : "2017-11-09 13:25:03" string
etag 可选 样例 : "19349858cjs98ericu989" string
fileId 可选 样例 : 1216113551663296 integer (int64)
length 可选 样例 : 39044 integer (int64)
name 可选 样例 : "-1F.dwg" string
status 可选 样例 : "success" string
suffix 可选 样例 : "rvt" string

成功结果示例

{
  "code" : "success",
  "data" : {
    "createTime" : "2017-11-09 13:25:03",
    "etag" : "19349858cjs98ericu989",
    "fileId" : 1216113551663296,
    "length" : 39044,
    "name" : "-1F.dwg",
    "status" : "success",
    "suffix" : "rvt"
  },
  "message" : ""
}