# 新东方-获取PPT文件信息

### 接口URL

```
https://document-2.polyv.net/api/live/user/get
```

### 接口说明

```
1、获取PPT文件信息
2、接口支持https协议
```

### 支持格式

```
JSON
```

### 请求方式

```
GET
```

### 请求数限制

```
TRUE
```

### 请求参数

| 参数名    | 必选 | 类型     | 说明   |
| ------ | -- | ------ | ---- |
| autoId | 是  | string | 记录ID |
| fileId | 是  | string | 文件ID |
| userId | 是  | string | 用户ID |

### 响应成功JSON示例：

```json
{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "autoId": 1494154,
        "fileId": "98700a88ade105294013703810fcfc13cf7f07e096animate",
        "fileName": "animate.pptx",
        "fileUrl": "http://doc-2.polyv.net/sources/20201028/98700a88ade105294013703810fcfc13cf7f07e096animate.pptx",
        "fileType": ".pptx",
        "totalPage": 2,
        "channelId": "cf7f07e096",
        "status": "normal",
        "createTime": 1603873152000,
        "convertType": "animate",
        "smallImagesZip": "http://doc-2.polyv.net/images/2020/10/98700a88ade105294013703810fcfc13cf7f07e096animate/smallImages.zip",
        "imagesZip": "http://doc-2.polyv.net/images/2020/10/98700a88ade105294013703810fcfc13cf7f07e096animate/images.zip",
        "htmlUrlZip": "http://doc-2.polyv.net/images/2020/10/98700a88ade105294013703810fcfc13cf7f07e096animate/98700a88ade105294013703810fcfc13cf7f07e096animate.zip"
    }
}
```

### 响应失败JSON示例：

记录ID非法

```json
{
    "code": 400,
    "status": "error",
    "message": "autoId is illegal",
    "data": ""
}
```

### 字段说明

| 参数名                 | 说明                                                                                                                                           |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| code                | 请求状态响应码                                                                                                                                      |
| status              | 请求状态                                                                                                                                         |
| message             | 错误信息                                                                                                                                         |
| data                | 请求失败时为空，请求成功为成功信息                                                                                                                            |
| data.autoId         | 记录ID                                                                                                                                         |
| data.fileId         | 文件ID                                                                                                                                         |
| data.status         | PPT状态，“normal” 正常，不需要重复上传文件，已经有上传成功的相同PPT，可以直接进入轮询。“waitConvert”转换PPT中，已经有相同的文件正在转换中，直接进入轮询。“waitUpload” 等待上传状态，进入上传阿里云步骤。“failConvert” 转换失败 |
| data.fileUrl        | 文件地址                                                                                                                                         |
| data.fileType       | 文件类型                                                                                                                                         |
| data.totalPage      | 总页数                                                                                                                                          |
| data.convertType    | 转换类型                                                                                                                                         |
| data.smallImagesZip | 小图ZIP地址                                                                                                                                      |
| data.imagesZip      | 大图ZIP地址                                                                                                                                      |
| data.htmlUrlZip     | 动效文件ZIP地址                                                                                                                                    |
| data.fileName       | 文件名                                                                                                                                          |

### java请求示例

```java
public static void test() {
        String url = "https://document-2.polyv.net/api/live/user/get";

        Map<String, String> params = new HashMap<>();
        params.put("fileId", "d8700a88ade105294013703810fcfc13cf7f07e096animate");
		params.put("autoId", "1492485");
		params.put("userId", "cf7f07e096");
        // 调用Polyv的httpClient工具类发送请求
        String content = HttpClientUtil.getInstance().sendHttpPost(url, params);
        System.out.println(content);
    }
```
