ApsaraVideo VOD expose des OpenAPI pour la gestion et le contrôle des ressources multimédias. Appelez ces API à l'aide du SDK Alibaba Cloud, de l'interface CLI Alibaba Cloud ou d'outils d'infrastructure en tant que code (IaC).
OpenAPI ApsaraVideo VOD
ApsaraVideo VOD fournit des OpenAPI couvrant l'intégralité du cycle de vie des médias, notamment le téléchargement, la gestion, le traitement, la distribution et la lecture. Intégrez ces API dans votre application pour gérer les ressources cloud par programmation. Si vous ne connaissez pas bien OpenAPI et ses principes, consultez la rubrique Qu'est-ce qu'OpenAPI.
Guide des versions d'OpenAPI
Alibaba Cloud utilise des numéros de version pour gérer les listes d'opérations entre les principales versions d'API de chaque service cloud.
Par exemple, ApsaraVideo VOD prend actuellement en charge la version d'API 2017-03-21. 2017-03-21 est un identifiant de version et non une date ; il reflète toujours les dernières opérations d'API publiques.
|
Numéro de version de l'API |
Description |
|
Recommandée |
Débogage en ligne
Déboguez les opérations de l'API ApsaraVideo VOD directement depuis le portail OpenAPI. Avant d'appeler une API, familiarisez-vous avec la version de l'API, l'endpoint et la méthode d'intégration.
Point d'entrée pour le débogage des API : https://next.api.alibabacloud.com/api/vod/2017-03-21/
Description des endpoints
Sélectionnez un endpoint en fonction de la région où se trouve votre ressource afin de réduire la latence.
ApsaraVideo VOD déploie des services de gestion et de contrôle dans plusieurs régions. Utilisez des noms de domaine spécifiques à la région au format vod.{regionId}.aliyuncs.com.
Pour une latence plus faible, utilisez également des noms de domaine VPC au format vod-vpc.{regionId}.aliyuncs.com.
Pour plus d'informations sur les endpoints, consultez la rubrique Endpoints de service.
Identités prises en charge
Les identités suivantes sont prises en charge. Nous vous recommandons d'utiliser un utilisateur RAM ou un rôle RAM et de n'accorder que les permissions requises avant d'appeler les opérations d'API.
Lorsque vous vous connectez au portail OpenAPI avec votre compte Alibaba Cloud, le portail utilise par défaut votre identité actuelle pour le débogage. Nous vous recommandons vivement d'utiliser un utilisateur RAM pour les appels d'API et les opérations quotidiennes d'O&M. Accordez à l'utilisateur RAM uniquement les permissions requises par votre activité. Pour plus d'informations, consultez la rubrique Utilisation de RAM pour le contrôle d'accès.
|
Identité |
Prise en charge |
|
Prise en charge |
|
|
Utilisateur RAM (recommandé) |
Prise en charge |
|
Rôle RAM (recommandé) |
Prise en charge |
Informations complémentaires
Méthodes d'appel prises en charge
Appelez l'API ApsaraVideo VOD à l'aide de l'une des méthodes suivantes.
SDK Alibaba Cloud (recommandé)
Le SDK Alibaba Cloud est la méthode recommandée et la mieux prise en charge pour appeler les opérations OpenAPI. ApsaraVideo VOD propose des SDK dans plusieurs langages de programmation qui vous permettent de mettre en œuvre des fonctionnalités telles que la lecture vidéo, le filigrane, le découpage et la conversion du direct vers la VOD sans programmation complexe. Pour plus d'informations, consultez la rubrique SDK serveur.
CLI Alibaba Cloud
La CLI Alibaba Cloud vous permet de gérer les ressources cloud depuis un terminal en ligne de commande à l'aide de la commande aliyun. Pour plus d'informations, consultez la rubrique Présentation de la CLI Alibaba Cloud.
Encapsulation personnalisée des appels d'API
Si les méthodes précédentes ne répondent pas à vos besoins, construisez manuellement des requêtes HTTP. Cela nécessite la mise en œuvre de l'algorithme de signature et la création d'en-têtes de requête personnalisés. Pour plus d'informations, consultez la rubrique Mécanisme de corps de requête et de signature V3.
Notes
Si une erreur est renvoyée après l'appel de l'API ApsaraVideo VOD, vérifiez la validité des paramètres de la requête en vous basant sur le code d'erreur. Pour plus d'informations, consultez la rubrique Codes d'erreur courants.
Enregistrez également l'identifiant RequestID renvoyé par l'appel ou le message d'erreur du SDK, puis utilisez la plateforme de diagnostic OpenAPI d'Alibaba Cloud pour effectuer un autodiagnostic.