1. 创建断点续传文件
用于断点续传创建可追加文件信息。
请求方式:POST
请求地址:/api/{databaseKey}/files/resumable
1.1. 请求参数
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | 操作的通关令牌 |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
databaseKey | string | test | 是 | 数据库key,必传 |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
无参数 | NULL | NULL | NULL | NULL |
Body
application/json:
{
"name": "xxx.ifc", //待上传的文件名,必选
"size": "xxx" //文件的大小,必传
}
1.2. 参数说明
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
name | string | xxx.ifc | 是 | 待上传的文件名 |
size | int | xxx | 是 | 文件的大小 |
1.3. 正确返回
{
"message": "请求处理成功",
"code": "SUCCESS",
"data": {
"size": xxx,
"name": "xxx.ifc",
"key": "Z3JvdXAxL……"
}
}
1.4. 状态码
状态码 | code | message | data | 原因 |
---|---|---|---|---|
400 | BAD_PARAMETER | 参数(name)应以.ifc、.3ds、.dwg或.zip结尾 | NULL | 当name不含后缀或后缀不是ifc、dwg、.3ds或zip时 |
400 | BAD_PARAMETER | 参数(size)应为大于零的整数 | NULL | 当size格式错误或小于等于零时 |
400 | BIZ_EXCEPTION | 数据库创建者的存储空间已达限额 | NULL | 当文件总量已超数据库创建者的存储空间限额时 |
1.5. 备注
暂无备注
1.6. 注意事项
1、文件名(name)必须带后缀,比如xxx.ifc、xxx.dwg或者xxx.zip。IFC、DWG类型的文件可以直接上传,也可以压缩后上传;其他类型如REVIT、IMODEL、OBJ、FBX、DAE,需要打成zip压缩包。
2、文件大小(size)为整数,精确到字节。
3、如果数据库创建者的存储空间有限制,则需检查数据库创建者所建的所有数据库的模型文件总量是否超过限额。校验规则:待上传文件大小+数据库创建者创建的所有库中的模型文件大小大于等于数据库创建者存储容量。