视频点播面向媒资管控等场景开放了大量的OpenAPI,您可使用配套的阿里云SDK、阿里云CLI、IaC工具完成接口调用。
点播OpenAPI
视频点播提供了从媒体上传、媒体管理、媒体处理、媒体分发、媒体播放全生命周期的OpenAPI,您可根据需要在业务中集成OpenAPI,完成云上资源管控。如果您还不了解OpenAPI及其原理,可参考什么是OpenAPI。
OpenAPI版本说明
阿里云OpenAPI通过版本号管控各时期云产品大版本的API列表。
例如:视频点播目前支持2017-03-21
版本的API列表,2017-03-21
代表的是API版本号而非时间概念,所展示API接口的是最新的API公开数据。
API 版本号 | 说明 |
推荐使用 |
在线调试
视频点播在OpenAPI门户提供API调试等功能。在调用前,您需要了解视频点播提供的版本、接入点说明、集成方式等信息。
调试API入口为:https://next.api.alibabacloud.com/api/vod/2017-03-21/
接入点说明
根据相关资源所在地域,选择对应的服务接入点地址,以获得最低延迟。
视频点播服务在多个地域均部署管控服务,可使用region化域名,格式为vod.{regionId}.aliyuncs.com
。
如果想要获得更快的响应速度,也可使用VPC域名,格式为vod-vpc.{regionId}.aliyuncs.com
。
更多接入点信息请参见服务接入点。
支持的用户身份
当前产品支持通过如下用户身份调用API。推荐您使用RAM用户或RAM角色,根据业务的实际情况按需分配权限后进行接口调用。
您阿里云账号登录OpenAPI网站后,OpenAPI默认使用您当前登录阿里云的用户身份进行在线OpenAPI调试。强烈建议您创建并使用RAM用户进行API访问或日常运维。请根据业务的实际情况按需分配权限后进行接口调用。RAM用户需具备操作权限。具体操作,请参见使用RAM进行访问控制。
用户身份 | 支持情况 |
支持 | |
RAM用户(推荐) | 支持 |
RAM角色(推荐) | 支持 |
更多信息
支持的调用方式
您可以通过以下方式调用视频点播OpenAPI。
阿里云SDK(推荐)
阿里云SDK是最易于集成,且支持度最好的OpenAPI调用方式,推荐您选择使用SDK。视频点播提供了多种主流语言的SDK,您可以基于阿里云SDK编写代码来调用视频点播API,不用复杂编程即可实现视频播放、视频图文水印、视频剪辑、直播转点播等功能,更多详情请参见服务端SDK。
阿里云CLI
阿里云命令行工具可以帮助您在使用命令行终端时,使用aliyun
命令与阿里云服务进行交互,管理云服务资源。有关阿里云CLI的更多详细信息,请参见什么是阿里云CLI。
自定义封装API调用
如果以上方案均无法满足您的业务需要,可自行封装请求调用OpenAPI(不推荐),原生HTTP调用需要您自己实现签名算法,并构建自定义请求,发起HTTP调用。有关签名机制的更多详细信息,请参见V3版本请求体&签名机制。
注意事项
如果调用视频点播API后返回错误,您需要根据返回的错误码提示检查传入的请求参数及其取值是否正确。更多信息,请参见公共错误码。
您也可以记录下调用返回的RequestID或SDK报错信息,通过阿里云OpenAPI诊断平台进行自助诊断。