# 指定外部文件url方式上传

PUT https://file.bimface.com/upload

# 说明

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

该接口仅支持默认项目的默认文件夹，其他项目或文件夹请使用文件管理服务的接口。

# 参数

Authorization *

Bearer {accessToken}

string

*为必填项

# Query

etag	文件etag	string
name *	文件的全名，使用URL编码（UTF-8），最多256个字符	string
sourceId	调用方的文件源ID，不能重复	string
url *	文件所在url	string

*为必填项

# 响应

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

# 200响应参数

GeneralResponse«FileBean»

名称	说明	类型
code	返回码	string
data	返回数据	FileBean
createTime	文件创建时间	string
length	文件字节数	int64
name	文件名称	string
etag	文件etag	string
suffix	文件后缀	string
fileId	文件ID	int64
status	上传状态	string
message	提示消息	string

# 消耗

application/json

# 生成

*/*
application/json

# HTTP请求示例

# 请求 path

https://file.bimface.com/upload/url?name=example.rvt&url=http://sample.bimface.com/attach/sample.rvt

"Authorization: Bearer cn-e9725999-0b36-4c0e-bdca-38ea88888888"

# HTTP响应示例

# 响应 200

{
  "code" : "success",
  "data" : {
    "createTime" : "2018-11-21 18:33:44",
    "etag" : "None",
    "fileId" : 1938888813662976,
    "length" : 6459392,
    "name" : "sample.rvt",
    "status" : "uploading",
    "suffix" : "rvt"
  },
  "message" : ""
}