# 新东方-获取上传PPT文件token

### 接口URL

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

### 接口说明

```
1、获取上传PPT文件token
2、接口支持https协议
3、上传文件到OSS参考 https://www.alibabacloud.com/help/zh/doc-detail/31927.htm
```

### 支持格式

```
JSON
```

### 请求方式

```
GET
```

### 请求数限制

```
TRUE
```

### 请求参数

| 参数名      | 必选 | 类型     | 说明                                    |
| -------- | -- | ------ | ------------------------------------- |
| fileId   | 是  | string | 文件ID (文件MD5+userId+type)              |
| userId   | 是  | string | 用户ID                                  |
| type     | 是  | string | PPT类型，“common” 普通ppt ， “animate”动画PPT |
| fileName | 是  | string | 文件名称                                  |

### 响应成功JSON示例：

等待上传

```json
{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "encodedCallback": "eyJjYWxsYmFja1VybCI6Imh0dHA6Ly9kb2N1bWVudC0yLnBvbHl2Lm5ldC90ZXN0L2FsaS9vc3MvY2FsbGJhY2svdXBsb2FkIiwiY2FsbGJhY2tIb3N0IjoiZG9jdW1lbnQtMi5wb2x5di5uZXQiLCJjYWxsYmFja0JvZHkiOiJvYmplY3Q9JHtvYmplY3R9JnNpemU9JHtzaXplfSZidWNrZXQ9JHtidWNrZXR9JmV0YWc9JHtldGFnfSZhdXRvSWQ9MTQ5MzcxNyZmaWxlSWQ9ZDg3MDBhODhhZGUxMDUyOTQwMTM3MDM4MTBmY2ZjMTNjZjdmMDdlMDk2YW5pbWF0ZSIsImNhbGxiYWNrQm9keVR5cGUiOiJhcHBsaWNhdGlvbi94LXd3dy1mb3JtLXVybGVuY29kZWQifQ==",
        "signature": "fcrT21oNF7CMxAdI70D20hUu1fE=",
        "autoId": "1493717",
        "dir": "sources/20201028/",
        "bucket": "polyvppt",
        "accessId": "LTAIjy1Mrh8QQcQH",
        "endpoint": "oss-cn-shenzhen.aliyuncs.com",
        "expire": "1603941652",
        "host": "http://polyvppt.oss-cn-shenzhen.aliyuncs.com",
        "callback": "{\"callbackUrl\":\"http://document-2.polyv.net/test/ali/oss/callback/upload\",\"callbackHost\":\"document-2.polyv.net\",\"callbackBody\":\"object=${object}&size=${size}&bucket=${bucket}&etag=${etag}&autoId=1493717&fileId=d8700a88ade105294013703810fcfc13cf7f07e096animate\",\"callbackBodyType\":\"application/x-www-form-urlencoded\"}",
        "convertStatus": "waitUpload",
        "fileId": "d8700a88ade105294013703810fcfc13cf7f07e096animate",
        "object": "sources/20201028/d8700a88ade105294013703810fcfc13cf7f07e096animate.pptx",
        "policy": "eyJleHBpcmF0aW9uIjoiMjAyMC0xMC0yOVQwMzoyMDo1Mi42OTJaIiwiY29uZGl0aW9ucyI6W1siY29udGVudC1sZW5ndGgtcmFuZ2UiLDAsMzIyMTIyNTQ3MjBdLFsic3RhcnRzLXdpdGgiLCIka2V5Iiwic291cmNlcy8yMDIwMTAyOC8iXV19"
    }
}
```

等待转换

```json
{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "autoId": "1492485",
        "convertStatus": "waitConvert",
        "fileId": "18947167af136724418f3cfa32343b29cf7f07e096animate"
    }
}
```

转换成功

```json
{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "autoId": "1493717",
        "convertStatus": "normal",
        "fileId": "d8700a88ade105294013703810fcfc13cf7f07e096animate"
    }
}
```

### 响应失败JSON示例：

文件类型错误

```json
{
    "code": 400,
    "status": "error",
    "message": "file type is wrong",
    "data": ""
}
```

### 字段说明

| 参数名                  | 说明                                                                                                                                           |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| code                 | 请求状态响应码                                                                                                                                      |
| status               | 请求状态                                                                                                                                         |
| message              | 错误信息                                                                                                                                         |
| data                 | 请求失败时为空，请求成功为成功信息                                                                                                                            |
| data.autoId          | 记录ID                                                                                                                                         |
| data.fileId          | 文件ID                                                                                                                                         |
| data.convertStatus   | PPT状态，“normal” 正常，不需要重复上传文件，已经有上传成功的相同PPT，可以直接进入轮询。“waitConvert”转换PPT中，已经有相同的文件正在转换中，直接进入轮询。“waitUpload” 等待上传状态，进入上传阿里云步骤。“failConvert” 转换失败 |
| data.accessId        | oss上传OSSAccessKeyId                                                                                                                          |
| data.signature       | oss上传signature                                                                                                                               |
| data.policy          | oss上传policy                                                                                                                                  |
| data.endpoint        | oss上传的endpoint                                                                                                                               |
| data.encodedCallback | oss上传的回调参数BASE64编码                                                                                                                           |
| data.callback        | oss上传的回调参数                                                                                                                                   |
| data.object          | oss上传文档key                                                                                                                                   |
| data.host            | oss上传地址                                                                                                                                      |
| data.bucket          | oss上传桶                                                                                                                                       |
| data.expire          | oss上传有效时间                                                                                                                                    |
| data.dir             | 上传到oss的文件夹                                                                                                                                   |

### java请求示例

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

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