全部产品
云市场

获取辅助媒资上传地址和凭证

更新时间:2019-04-11 12:17:12

描述

获取辅助媒资上传地址和凭证,辅助媒资包括水印、字幕文件等。

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值: CreateUploadAttachedMedia
BusinessTypeString业务类型。取值范围:
  • watermark(水印)
  • subtitle(字幕)
  • material(素材)
MediaExtString文件扩展名。取值范围:
  • 水印:png、gif、apng、mov
  • 字幕:srt、ass、stl、ttml、vtt
  • 素材:jpg、gif、png、mp4、mat、zip
TitleString标题。规则:
  • 长度不超过128个字节。
  • UTF8编码。
CateIdsString分类ID。
  • 多个英文逗号分隔。最多支持5个。
  • 可以在 点播控制台 > 全局设置 > 分类管理 中编辑或查看分类的ID。
FileNameString源文件名。
    FileSizeString文件大小。单位:字节。
    TagsString标签。规则:
    • 单个标签不超过32字节。
    • 最多不超过16个标签。
    • 多个用逗号分隔。
    • UTF8编码。
    DescriptionString描述。
    • 长度不超过1024个字节。
    • UTF8编码。
    StorageLocationString存储地址。当不为空时,会使用该指定的存储地址上传文件。可在 点播控制台 > 存储管理 里查看存储地址。
    UserDataUserData自定义设置,为JSON字符串,支持消息回调等设置。
    AppId String应用ID。取值如:app-1000000。使用说明参考文档 多应用

    返回参数

    名称类型描述
    RequestId String 请求ID。
    UploadAddressString 上传地址。
    UploadAuth String 上传凭证。
    MediaId String 媒资ID。
    MediaURL String 媒资地址。如果配置了CDN域名则返回CDN地址,否则为OSS地址。
    FileURL String 文件oss地址(不带鉴权)。添加水印时该地址可做为添加水印接口的入参FileUrl。

    注意:

    • 该接口不会真正上传辅助媒资文件,您需要在获取上传地址和凭证后,使用上传SDK进行文件上传(和视频、图片上传相同)。
    • 如果上传凭证失效(有效期3000秒),请重新调用此接口获取上传地址和凭证。
    • 如果返回的MediaURL在浏览器无法访问(403),是因为您开启了点播域名的鉴权功能。可关闭 URL鉴权 或自助 生成鉴权签名
    • 更多使用说明参考 上传地址和凭证

    API示例

    请求示例

    1. http://vod.cn-shanghai.aliyuncs.com/?Action=CreateUploadAttachedMedia&MediaType=watermark&MediaExt=mov&Format=JSON&<公共参数>

    注意:示例中的“公共参数”参见 公共参数说明文档

    返回示例

    JSON格式

    1. {
    2. "RequestId": "C1E04A5B-BFD8-4BD8-BA96-95E7CEBXXXXX",
    3. "MediaId": "xxxxxxxxxxxxxxxxxxxxxxx",
    4. "UploadAddress": "eyJFbmRwb2lud...",
    5. "UploadAuth": "eyJTZWN1cml0e..."
    6. "FileURL": "https://sample.oss-cn-shanghai.aliyuncs.com/watermark/xxxx.mov",
    7. "MediaURL": "http://sample.com/watermark/xxxx.mov?auth_key=xxxx",
    8. }

    SDK示例

    建议使用 服务端SDK 来调用API,此API各语言调用的示例代码,请参考如下: