1. 生成模型缩略图
开始生成模型缩略图。
请求方式：POST
请求地址：/api/{databaseKey}/models/thumbnail
1.1. 请求参数
Headers：
| 参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
|---|---|---|---|---|
| Authorization | string | c4570cb9ca324bc8ba7dd9d1967710ea | 是 | 操作的通关令牌 |
PathParas：
| 参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
|---|---|---|---|---|
| databaseKey | string | test | 是 | 数据库key，必传 |
SearchParas：
| 参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
|---|---|---|---|---|
| NULL | NULL | NULL | NULL | NULL |
Body
application/json:
{
"modelKey": "M1599732658374",
"redo": true // 可选，需要重新生成时设置。
}
1.2. 参数说明
| 参数名 | 类型 | 示例 | 是否必填 | 参数含义 |
|---|---|---|---|---|
| modelKey | string | M1599732658374 | 是 | 模型key |
| redo | boolean | true | 否 | 需要重新生成时设置 |
1.3. 正确返回
{
"message": "请求处理成功",
"code": "SUCCESS",
"data": {
"timestamp": "2020-09-11 15:16:40",
"type": "AUTO",
"format": "png",
"status": "GENERATING"
}
}
1.4. 状态码
| 状态码 | code | message | data | 原因 |
|---|---|---|---|---|
| 400 | BIZ_EXCEPTION | 模型缩略图正在生成中 | NULL | 缩略图正在生成时 |
| 400 | MODEL_NOT_FOUND | 模型（M1599818125427）不存在 | NULL | 模型不存在时 |
| 400 | SUCCESS | 请求处理成功 | {"timestamp": "2020-09-11 15:16:40","type": "AUTO","format":"png","status": "GENERATED","fileKey": "xxxxxxxxxxxxxxxxxxx"} | 缩略图已经生成时,正常返回缩略图信息 |
1.5. 备注
暂无备注
1.6. 注意事项
当模型不存在时，返回错误信息
缩略图正在生成中时，返回错误信息
缩略图已经生成时，如果redo未设置为true，则返回缩略图信息
缩略图已经生成，如果想重新生成，需要在body里面设置redo:true
此接口调用时，缩略图的类型是auto，如果是通过自定义上传的缩略图，类型是CUSTOMIZE。
如果是redo的，旧的缩略图将从fastdfs中删除。
此接口调用时，缩略图的格式是png格式。
数据库启用gacl时，有模型关联的BOSF文档读取权限的用户。
数据库未启用gacl时，有数据库访问权限的用户。