API：追加上传

POST  https://file.bimface.com/appendFiles

根据创建的追加文件信息进行追加上传。

---

请求（Request）

Header

key	value	示例
Authorization	bearer {accessToken}	bearer xxxx-xxxx-xxxx-xxxx
Content-Type	application/json	…

Url Parameter

字段	类型	必填	描述	示例
appendFileId	Number	Y	追加文件id	1199714943746080
position	Number	N	追加上传开始位置，默认为0	0

Request Body

文件流（以追加上传开始位置开始的文件流）

curl -X POST 
-H "Authorization: bearer <your accessToken>" 
-H "Content-Type: application/json" 
"https://file.bimface.com/appendFiles/{appendFileId}/data?position={position}"

---

响应（Response）

HTTP STATUS

200

成功返回

{
    "code": "success",
    "message": null,
    "data": {
        "appendFileId": 1199714943746080,       
        "length": 23440,
        "name": "testA.rvt",
        "position": 23440,
        "status": "complete",
        "createTime": "2017-10-17 09:21:59"
        "file": { // 如果append file的状态不是complete，file为null
            "fileId": 988971984749344,
            "name": "test.rvt",
            "suffix": "rvt",
            "etag": "BA01EF719227C7C6B4F634C1EB52F5CE",
            "length": 23440,
            "status": "success",
            "createTime": "2017-10-17 09:23:50"
        }
}

字段	类型	描述	示例
fileId	Long	文件id
name	String	文件名
suffix	String	文件名后缀
etag	String	文件etag
length	Long	文件长度
status	String	上传状态
createTime	String	创建时间

失败返回

{
    "code": "authentication.failed",
    "message": "Token was not recognized."
}

错误码

code	说明
system.error	BIMFACE系统异常
authentication.failed	API访问合法性校验失败
invalid.append.position	position与已上传长度不一致
append.upload.aborted	文件没有上传完成
sourceid.invalid	source id不合法