API 文档
搜索文档…
上传文档 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
}