1. 上传自定义模型缩略图
上传自定义的模型缩略图。
请求方式:POST
请求地址:/api/{databaseKey}/models/thumbnail/upload
1.1. 请求参数
Headers:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | 操作的通关令牌 |
PathParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
databaseKey | string | test | 是 | 数据库key,必传 |
SearchParas:
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
NULL | NULL | NULL | NULL | NULL |
Body
application/json:
multipart/form-data
{
"modelKey": "M1599732658374",
"file": "缩略图文件.jpg"
}
1.2. 参数说明
参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
---|---|---|---|---|
modelKey | string | M1599732658374 | 是 | 模型key |
file | string | 缩略图文件.jpg | 否 | 文件名 |
1.3. 正确返回
{
"message": "请求处理成功",
"code": "SUCCESS",
"data": {
"timestamp": "2020-09-11 15:16:40",
"type": "CUSTOMIZE",
"format": "jpg",
"status": "GENERATED",
"fileKey": "Z3JvdXAxLE0wM…UFKODFtSGN0MTAzNDcuanBn",
}
}
1.4. 状态码
状态码 | code | message | data | 原因 |
---|---|---|---|---|
400 | BIZ_EXCEPTION | 模型缩略图正在生成中 | NULL | 缩略图正在生成时 |
400 | MODEL_NOT_FOUND | 模型(M1599818125427)不存在 | NULL | 模型不存在时 |
1.5. 备注
暂无备注
1.6. 注意事项
- 当模型缩略图正在生成时,不能上传自定义缩略图
- 缩略图自动生成完成时,可以上传替换自定义缩略图
- 没有缩略图时,也可以直接进行上传自定义缩略图
- 自定义缩略图,type为CUSTOMIZE,status直接为GENERATED
- 自定义的缩略图格式有:jpeg\jpg\png\gif\bmp
- 数据库启用gacl时,有模型关联的BOSF文档读取权限的用户。
- 数据库未启用gacl时,有数据库访问权限的用户。