接口描述

该接口（ApplyUpload）用于申请将音视频文件上传到媒资管理后台。

请求语法

POST  /api/v1/media/ HTTP/1.1
Host:  api.vod.frontwize.com
Content-Type: application/json
Date: <date>
Authorization: <authorization-string>

请求参数

参数 是否必选 参数类型 描述 示例值

Title

是

String

媒资标题，长度不超过 128 个字节，UTF-8 编码。

视频标题

Region

是

String

区域。
如果用户传入非默认区域，返回失败。

pek3b

MediaType

是

String

上传音视频文件的格式。
取值如下：

  • 视频文件：MP4、TS、MOV、MXF、MPG、FLV、WMV、AVI、M4V、F4V、MPEG、3GP、ASF、MKV、HLS

  • 音频文件：MP3、OGG、WAV、WMA、APE、FLAC、AAC、AC3、MMF、AMR、M4A、M4R、WV、MP2

若上传格式为音频文件，则不支持转码、添加水印和字幕。

AVI

Description

否

String

视频描述，长度不超过 1024 个字节。

描述

CategoryId

否

String

媒资分类 ID。预留参数。

-

CoverType

否

String

封面图片文件类型。预留参数。

-

Templates

否

list

转码模板。
Type：
1：视频转码
2：自适应码流
4：音频转码
16：裁剪
32：水印

[{"Type": 模板类型 int，"Id": 模板id int}]

Tasks

否

list[taskid]

任务模板。如果两者都有，以 task 为准。

[123,345]

ExtInfo

否

String

保留字段，特殊用途时使用。

-

AppId

否

int

目前是预留字段。

-

返回参数

参数 参数类型 描述

MediaId

String

媒体 ID。

StorageBucket

String

对象存储的存储空间（Bucket）名称。

StorageRegion

String

存储空间所在区域。

StoragePath

String

文件的存储地址，对应存储的 key。
说明

从该接口获得上传地址后，利用该地址可进行文件的上传，具体代码可参考示例，上传的更详细信息可参考 Post Object。

请求示例

POST  /api/v1/media/ HTTP/1.1
Accept: application/json, text/plain, */*
Accept-Encoding: gzip, deflate
Accept-Language: en-US,en;q=0.9,zh-CN;q=0.8,zh;q=0.7
Connection: keep-alive
Content-Length: 328
Content-Type: application/json; charset=UTF-8
Host: api.vod.frontwize.com
Authorization: authorization string
{
  "Title": "50591129875255296.mp4",
  "Region": "pek3b",
  "MediaType": "video/mp4"
}

响应示例

HTTP/1.1 200 OK
Date: Thu, 26 May 2022 06:18:09 GMT
Content-Type: application/json
Transfer-Encoding: chunked
Connection: keep-alive
Vary: Accept-Language,Cookie
Content-Language: zh-cn
Content-Encoding: gzip
x-qvod-request-id: aa08cf7a43f611e5886952542e6ce14b
{
  "StorageBucket": "",
  "MediaId": "52746780168687616",
  "StoragePath": "https://qvod6ajnshtgnbkpnks.s3.pek3b.qingstor.com/vod/52746780168687616.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=YLIODQRBPUONJZAQHDKR%2F20220526%2Fpek3b%2Fs3%2Faws4_request&X-Amz-Date=20220526T061753Z&X-Amz-Expires=180&X-Amz-SignedHeaders=host&X-Amz-Signature=532d430cee2542319d48be2787a8ed2868294693cafdb04d97b387ca3e285e3c",
  "StorageRegion": "",
  "ret_code": 0
}

注意：此请求会返回实际文件上传的地址，可以根据该地址进行上传，参考示例代码如下。

func httpSendVideo(method string, url string, body string) (map[string]interface{}, error) {
  httpclient := &http.Client{Timeout: 2 * time.Minute}

  var Req *http.Request
  if len(body) == 0 {
    Req, _ = http.NewRequest(method, url, nil)
  } else {
    Req, _ = http.NewRequest(method, url, strings.NewReader(body))
  }

  // 此处 Content-Type 需要传媒体实际的 mime type，如此处是 mp4
  Req.Header.Set("Content-Type", "video/mp4")

  resp, err := httpclient.Do(Req)
  defer resp.Body.Close()
  if err != nil {
    return nil, err
  }
}