O ApsaraVideo VOD disponibiliza OpenAPIs para gerenciamento e controle de ativos de mídia. Você pode chamar essas APIs usando 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 em nuvem programaticamente. Caso não esteja familiarizado com o OpenAPI e seus princípios, consulte O que é OpenAPI.
Guia de versões do OpenAPI
A Alibaba Cloud utiliza números de versão para gerenciar listas de operações nas principais versões de API de cada serviço em nuvem.
Por exemplo, o ApsaraVideo VOD suporta atualmente a versão de API 2017-03-21. O identificador 2017-03-21 representa uma versão, e não uma data, refletindo sempre as operações de API públicas mais recentes.
|
Número da versão da API |
Descrição |
|
Recomendada |
Depuração online
É possível depurar 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 serviços de gerenciamento e controle em várias regiões. Utilize nomes de domínio específicos da região no formato vod.{regionId}.aliyuncs.com.
Para obter menor latência, utilize também nomes de domínio VPC no formato vod-vpc.{regionId}.aliyuncs.com.
Para mais informações sobre endpoints, consulte Endpoints de serviço.
Identidades suportadas
As identidades listadas abaixo são suportadas. Recomendamos o uso de um usuário RAM ou função RAM, concedendo 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 utiliza sua identidade atual para depuração por padrão. Recomendamos fortemente o uso de 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 detalhes, consulte Usar RAM para controle de acesso.
|
Identidade |
Suporte |
|
Suportada |
|
|
Usuário RAM (recomendado) |
Suportado |
|
Função RAM (recomendado) |
Suportada |
Mais informações
Métodos de chamada suportados
Utilize 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, permitindo implementar recursos como reprodução de vídeo, marca d'água, recorte e live-to-VOD sem programação complexa. Para mais informações, consulte Server SDK.
Alibaba Cloud CLI
O Alibaba Cloud CLI permite gerenciar recursos em nuvem a partir de um terminal de linha de comando usando o comando aliyun. Para mais detalhes, consulte O que é Alibaba Cloud CLI.
Encapsulamento personalizado de chamadas de API
Caso os métodos anteriores não atendam aos seus requisitos, construa requisições HTTP manualmente. Isso exige a implementação do algoritmo de assinatura e a criação de cabeçalhos de requisição personalizados. Para mais detalhes, consulte Corpo da requisição V3 e mecanismo de assinatura.
Observações
Se um erro for retornado após chamar a API do ApsaraVideo VOD, verifique se os parâmetros da requisição são válidos com base no código de erro. Para mais informações, consulte Códigos de erro comuns.
Registre o RequestID retornado pela chamada ou a mensagem de erro do SDK e utilize a Plataforma de diagnóstico OpenAPI da Alibaba Cloud para autodiagnóstico.