# 生成文档缩略图任务接口 - createThumbnailTask
#### 功能介绍
生成文档缩略图任务接口，仅支持如下文档格式缩略图提取：
1.支持pdf文档文件后缀： pdf
2.支持word类文档文件后缀：docx, doc, dot, wps, wpt, dotx, docm, dotm, wpss, rtf
3.支持ppt类文档文件后缀： pptx, ppt, pot, potx, pps, ppsx, dps, dpt, pptm, potm, ppsm, dpss
4.支持excel类文档文件后缀：xls, xlt, xlsx, et, ett, xltx, xlsb, xlsm, xltm, ets
#### 授权信息
当前API调用无需身份策略权限。
#### URI
POST /koodrive/ose/v1/document/thumbnail
#### 请求参数
表1请求Header参数 
| 参数                   | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| Authorization        | 是    | String | 该字段存储的是Access Token。调用KooDrive的API使用Token认证，拥有Token就代表拥有某种权限，在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Access Token的获取请参考对应的开发手册，格式参考：Bearer+{access_token}                                                                                                                                                                                            |
| X-Traceid            | 否    | String | 消息日志跟踪标识（必须58位）                                                                                                                                                                                                                                                                                                                                          |
| language             | 否    | String | 国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语                                                                                                                                                                                                                                                                                                       |
| X-User-Id            | 是    | String | 用户id，用于app鉴权                                                                                                                                                                                                                                                                                                                                             |
| X-Date               | 是    | String | 日期，用于app鉴权                                                                                                                                                                                                                                                                                                                                               |
| x-hw-share-folder-id | 否    | String | 参数解释： 共享文件夹ID。如果传入了该请求头，则说明当前的操作是在共享文件夹内。 约束限制： 不涉及 取值范围： 不涉及 默认取值： 不涉及 |
   
表2请求Body参数 
| 参数          | 是否必选 | 参数类型   | 描述    |
|:---|:---|:---|:---|
| fileId      | 是    | String | 文件的ID |
| userId      | 是    | String | 用户ID  |
| containerId | 是    | String | 空间ID  |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数   | 参数类型    | 描述   |
|:---|:---|:---|
| code | Integer | 响应码  |
| msg  | String  | 响应信息 |
   
#### 请求示例
生成文档缩略图任务接口请求示例
```
/koodrive/ose/v1/document/thumbnail
Authorization:Bearer+10f88d07fa************44791e9ff
{
  "containerId": "IAAAKIRZGifzJgncA1605122035640590977",
  "fileId": "FkiferVNK5NwXck7XXBhPLIRhV1GayJPc",
  ”userId“: "1605107117323346560"
}
```
#### 响应示例
**状态码：200**
生成文档缩略图任务接口响应示例
```
{
  "code" : "0",
  "msg" : "success"
}
```
#### 状态码
| 状态码 | 描述              |
|:---|:---|
| 200 | 生成文档缩略图任务接口响应示例 |