上传文档 V2

接口

上传文档, 支持的文件后缀: doc、docx、pdf、ppt、pptx

POST /api/v2/activity/:id/doc

授权

请求 header

Authorization: Bearer <accessToken>
Content-Type: multipart/form-data

注:请将上方的 <accessToken> 替换为分配给您的秘钥串。关于如何获取 accessToken ,请咨询杨经理(18968187008)。

参数

请求样例

curl -H "Authorization: bearer <Access Token>" "http://shangzhibo.tv/api/v2/activity/:id/doc" -F file=@raft.pdf

文件上传示例代码:

<html>
    <form name="form" action="https://shangzhibo.tv/api/v2/activity/12345678/doc" method="POST" enctype ="multipart/form-data">
        <input type="file" name="filename">
        <input type="submit" value="submit">
    </form>
</html>

响应 200

HTTP/1.1 200 OK

响应样例

参数

参数类型

参数说明

taskId

string

转码任务 id,用于查询文档转码进度

{
    "taskId":"ef141163-2572-49fe-951a-1501cb7ce914"
}

响应 400

// 文档文件最大为 40MB
{
    "name":"BadRequest",
    "message":"文件大小超过限制",
    "status":400
}

// 文档只支持 pdf, ppt, word 三种,对应的后缀为 pdf, pptx, ppt, doc, docx
{
    "name":"BadRequest",
    "message":"不支持的文件类型",
    "status":400
}

// 每个请求文档上传数量限制为 1 个
{
      "name": 'BadRequest',
      "message": ' 一次最多只能传一个文件',
      "status": 400,
}

响应 429

{
    "name":"TooManyRequests",
    "message":"请求速度太频繁了, 请于xxx后重试",
    "status":429
}

最后更新于