保利威文档中心

帮助中心

POLYV 帮助中心

新东方-上传PPT文件

更新时间：2023-11-14 14:07:19

接口URL

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

接口说明

1、上传PPT文件
2、接口支持https协议

支持格式

JSON

请求方式

POST

请求数限制

TRUE

请求参数（FORM表单）

参数名 必选 类型 说明
userId 是 string 用户ID
type 是 string PPT类型，“common” 普通ppt ， “animate”动画PPT
callback 否 string 回调地址
file 是 file 上传文件
timestamp 是 long 时间戳
sign 是 string 签名，签名方式:'POLYV_USER_PPT'+ 'userId' + userId + 'timestamp' + timestamp + 'POLYV_USER_PPT' 字符串进行MD5大写

响应成功JSON示例：

{
    "code": 200,
    "status": "success",
    "message": "",
    "data": {
        "autoId": 1539983,
        "fileId": "3872476de0879e8a3d76ecc344b899b1cf7f07e096animate",
        "fileName": "123.pptx",
        "fileUrl": "http://doc-2.polyv.net/sources/20201202/3872476de0879e8a3d76ecc344b899b1cf7f07e096animate.pptx",
        "fileType": ".pptx",
        "totalPage": null,
        "channelId": "cf7f07e096",
        "status": "waitConvert",
        "createTime": 1606890386168,
        "convertType": "animate",
        "smallImagesZip": null,
        "imagesZip": null,
        "htmlUrlZip": null
    }
}

响应失败JSON示例：

{
    "code": 400,
    "status": "error",
    "message": "file type is wrong",
    "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 文件名

回调说明

1、PPT转换完成后通过POST方式间数据回调到用户的callback地址
2、用户成功接收回调后需要响应回调处理结果
3、没有接收到成功的响应回调结果，间隔5秒、10秒后会发起第二、第三次回调

回调请求数据JSON示例：

{
    "autoId": 1539983,
    "fileId": "3872476de0879e8a3d76ecc344b899b1cf7f07e096animate",
    "fileName": "123.pptx",
    "fileUrl": "http://doc-2.polyv.net/sources/20201202/3872476de0879e8a3d76ecc344b899b1cf7f07e096animate.pptx",
    "fileType": ".pptx",
    "totalPage": 2,
    "channelId": "cf7f07e096",
    "status": "normal",
    "createTime": 1606890386000,
    "convertType": "animate",
    "smallImagesZip": "http://doc-2.polyv.net/images/2020/12/3872476de0879e8a3d76ecc344b899b1cf7f07e096animate/smallImages.zip",
    "imagesZip": "http://doc-2.polyv.net/images/2020/12/3872476de0879e8a3d76ecc344b899b1cf7f07e096animate/images.zip",
    "htmlUrlZip": "http://doc-2.polyv.net/images/2020/12/3872476de0879e8a3d76ecc344b899b1cf7f07e096animate/3872476de0879e8a3d76ecc344b899b1cf7f07e096animate.zip"
}

回调数据说明

字段名 说明
autoId 记录ID
fileId 文件ID
status PPT状态，“normal” 正常，不需要重复上传文件，已经有上传成功的相同PPT，可以直接进入轮询。“waitConvert”转换PPT中，已经有相同的文件正在转换中，直接进入轮询。“waitUpload” 等待上传状态，进入上传阿里云步骤。“failConvert” 转换失败
fileUrl 文件地址
fileType 文件类型
totalPage 总页数
convertType 转换类型
smallImagesZip 小图ZIP地址
imagesZip 大图ZIP地址
htmlUrlZip 动效文件ZIP地址
fileName 文件名

回调响应数据JSON示例：

{
    "code": 200
}

响应字段说明

参数名 说明
code 请求状态响应码，返回200成功表示收到响应

java请求示例

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

        Map<String, String> params = new HashMap<>();
        params.put("callback", "http://biny.free.idcfengye.com/callback/ppt");
        params.put("type", "animate");
        params.put("userId", "cf7f07e096");
        // 调用Polyv的httpClient工具类发送请求
        String content = HttpClientUtil.getInstance().sendHttpPost(url, params);
        System.out.println(content);
    }
联系客服，在线咨询