文档

使用OpenAPI示例

本文介绍如何通过OpenAPI获取音视频上传地址和凭证,演示调用OpenAPI的完整步骤。

查看OpenAPI文档

在完成具体的业务目标之前,建议您先阅读接口文档CreateUploadVideo - 获取音视频上传地址和凭证,了解、学习调用该接口所需要的参数及权限等,更多信息请参见API概览

创建RAM用户并完成授权

身份

您可以使用阿里云账号(主账号)、RAM用户、RAM角色调用该接口,有关各种身份的差异请参见身份、凭据、授权

本案例中,我们使用RAM用户的身份进行接口调用。

  1. 登录RAM访问控制,创建一个仅允许API调用的RAM用户,更多详情请参见创建RAM用户

授权

  1. 访问RAM用户列表,单击目标RAM用户操作列的添加权限

  2. 在文本框中输入关键字VOD进行搜索,选择AliyunVODUploadAuth策略。

    说明

    AliyunVODFullAccess:管理视频点播服务的权限。

    AliyunVODReadOnlyAccess只读访问视频点播服务的权限。

    AliyunVODPlayAuth: 视频点播服务的播放权限。

    AliyunVODUploadAuth:视频点播服务的上传权限。

    如果想新建自定义权限,请参见授权信息

  3. 单击确认新增授权,完成授权操作。

调用OpenAPI

本文以Java语言SDK调用OpenAPI,其他语言SDK的用法类似,更多信息请参见视频点播SDK。您也可根据业务的实际需要选择其他调用方法,更多调用方法请参见调用方式

配置环境变量

配置环境变量ALIBABA_CLOUD_ACCESS_KEY_IDALIBABA_CLOUD_ACCESS_KEY_SECRET。具体操作,请参见在Linux、macOS和Windows系统配置环境变量

下载示例代码

  1. 访问CreateUploadVideo

  2. 在左侧的参数配置页签,填写需要的参数信息。

    1. FileName 参数输入示例值: product-introduction.mp4

    2. Title 参数输入示例值:产品介绍

  3. 在右侧的SDK示例页签,SDK版本选择v2.0,语言选择Java语言,单击下载完整工程按钮,下载示例代码包。

  4. 本地解压并进入alibabacloud_sample目录。

打开项目

使用IntelliJ IDEA加载项目,待相关依赖加载完毕后,打开src/main/java/com/aliyun/sample/Sample.java。根据代码中的注释提示自行添加打印返回值的代码。

运行项目

点击IDE右上角的运行按钮,可查看输出日志。本案例中的返回内容如下:

{
  "headers": {
    "access-control-allow-origin": "*",
    "date": "Wed, 12 Jul 2023 01:01:15 GMT",
    "keep-alive": "timeout=25",
    "transfer-encoding": "chunked",
    "vary": "Accept-Encoding",
    "x-acs-request-id": "DB669C38-72B2-539C-87E2-76D1E3AAC3E2",
    "connection": "keep-alive",
    "content-type": "application/json;charset=utf-8",
    "access-control-expose-headers": "*",
    "x-acs-trace-id": "a40b3573c2e372121a05767e5bfe****"
  },
  "body": {
    "UploadAddress": "***",
    "VideoId": "***",
    "RequestId": "DB669C38-72B2-539C-87E2-76D1E3AAC3E2",
    "UploadAuth": "***"
  },
  "statusCode": 200
}