获取视频播放凭证_音视频播放_服务端API

描述

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

请求参数

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

返回参数

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

API示例

请求示例

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

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

返回示例

JSON格式

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

错误码

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

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

SDK示例

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