# 指定文本url方式上传 API
# 请求URL
PUT https://apigate.glodon.com/bimface/file/upload
1
# 说明
如果需要上传的文件不在本地,且该文件可以通过指定的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/bimface/file/upload?name=example.dwg&url=http(s)://xxxxxxxxxxx
1
请求 header
"Authorization: Bearer dc671840-bacc-4dc5-a134-97c1918d664b"
1
请求成功数据说明
| 名称 | 说明 | 类型 |
|---|---|---|
| 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" : ""
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13