全部产品
云市场

获取视频播放凭证

描述

获取视频播放时所需的播放凭证。

请求参数

名称类型是否必需描述
ActionString系统规定参数。取值: GetVideoPlayAuth
VideoIdString视频ID
AuthInfoTimeoutLong播放凭证过期时间。取值范围:100~3000。
默认值:100秒
PlayConfigPlayConfig播放自定义设置,为JSON字符串,支持指定域名播放设置。
ReAuthInfoReAuthInfoCDN二次鉴权参数,为JSON字符串。当开启了CDN二次鉴权功能时,可通过该参数设置鉴权URL的uid和rand,详见 URL鉴权

返回参数

名称类型描述
RequestId String 请求ID。
VideoMeta VideoMeta 视频Meta信息。
PlayAuth String 视频播放凭证。

API示例

请求示例

  1. http://vod.cn-shanghai.aliyuncs.com/?Action=GetVideoPlayAuth&VideoId=93ab850b4f6f44eab54b6e91d24d81d4&Format=JSON&<公共参数>

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

返回示例

JSON格式

  1. {
  2. "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3. "VideoMeta": {
  4. "VideoId": "93ab850b4f6f44eab54b6e91d24d81d4",
  5. "Title": "阿里云VOD",
  6. "Duration": 135.6,
  7. "CoverURL": "https://image.example.com/sample.jpg",
  8. "Status": "Normal"
  9. },
  10. "PlayAuth": "sstyYuew678999ew90000000xtt7TYUh"
  11. }

错误码

下表列举了本接口特有的错误码。视频点播通用的错误码信息,参见 错误码表

错误代码错误信息HTTP 状态码说明
Forbidden.IllegalStatusStatus of the video is illegal.403视频状态无效。
InvalidVideo.NotFoundThe video does not exist.404视频不存在。

SDK示例

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