O ApsaraVideo VOD disponibiliza OpenAPIs para gerenciamento e controle de ativos de mídia. Chame essas APIs com o Alibaba Cloud SDK, o Alibaba Cloud CLI ou ferramentas de Infraestrutura como Código (IaC).
OpenAPI do ApsaraVideo VOD
O ApsaraVideo VOD oferece OpenAPIs que abrangem todo o ciclo de vida da mídia, incluindo upload, gerenciamento, processamento, distribuição e reprodução. Integre essas APIs à sua aplicação para gerenciar recursos na nuvem de forma programática. Se você não tiver familiaridade com a OpenAPI e seus princípios, consulte What is OpenAPI.
Guia de versões da OpenAPI
A Alibaba Cloud usa números de versão para gerenciar listas de operações nas principais versões de API de cada service em cloud.
Atualmente, o ApsaraVideo VOD suporta a versão de API 2017-03-21. O identificador 2017-03-21 representa uma versão, não uma data, e reflete sempre as operações de API pública mais recentes.
Número da versão da API | Descrição |
Recomendada |
Depuração online
Depure operações da API do ApsaraVideo VOD diretamente no portal OpenAPI. Antes de chamar uma API, familiarize-se com a versão da API, o endpoint e o método de integração.
Entrada para depuração de API: https://next.api.alibabacloud.com/api/vod/2017-03-21/
Descrição dos endpoints
Selecione um endpoint com base na região onde seu recurso está localizado para reduzir a latência.
O ApsaraVideo VOD implanta services de gerenciamento e controle em várias regiões. Use nomes de domínio específicos por região no formato vod.{regionId}.aliyuncs.com.
Para obter menor latência, use também nomes de domínio VPC no formato vod-vpc.{regionId}.aliyuncs.com.
Para mais informações sobre endpoints, consulte Service endpoints.
Identidades suportadas
As seguintes identidades são suportadas. Recomendamos usar um usuário RAM ou função RAM e conceder apenas as permissões necessárias antes de chamar operações de API.
Ao fazer login no portal OpenAPI com sua conta Alibaba Cloud, o portal usa sua identidade atual para depuração por padrão. Recomendamos fortemente usar um usuário RAM para chamadas de API e operações rotineiras de O&M. Conceda ao usuário RAM apenas as permissões exigidas pelo seu negócio. Para mais informações, consulte Use RAM for access control.
|
Identidade |
Suporte |
|
Suportado |
|
|
RAM user (recomendado) |
Suportado |
|
RAM role (recomendado) |
Suportado |
Mais informações
Métodos de chamada suportados
Use um dos métodos abaixo para chamar a API do ApsaraVideo VOD.
Alibaba Cloud SDK (recomendado)
O Alibaba Cloud SDK é a forma recomendada e com melhor suporte para chamar operações OpenAPI. O ApsaraVideo VOD fornece SDKs em diversas linguagens de programação que permitem implementar recursos como reprodução de vídeo, marca d'água, recorte e conversão de transmissão ao vivo para VOD sem programação complexa. Para mais informações, consulte Server SDK.
Alibaba Cloud CLI
O Alibaba Cloud CLI permite gerenciar recursos na cloud a partir de um terminal de linha de comando usando o comando aliyun. Para mais informações, consulte What is Alibaba Cloud CLI.
Encapsulamento personalizado de chamadas de API
Se os métodos anteriores não atenderem às suas necessidades, construa requisições HTTP manualmente. Essa abordagem exige implementar o algoritmo de assinatura e criar cabeçalhos de requisição personalizados. Para mais informações, consulte V3 request body & signature mechanism.
Observações
Se ocorrer um erro após chamar a API do ApsaraVideo VOD, verifique a validade dos parâmetros da requisição com base no código de erro. Para mais informações, consulte Common error codes.
Registre o RequestID retornado pela chamada ou a mensagem de erro do SDK e use a plataforma de diagnóstico da OpenAPI da Alibaba Cloud para autodiagnóstico.