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 propose 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 maîtrisez pas le concept d'OpenAPI et ses principes, consultez la rubrique Présentation d'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. L'identifiant 2017-03-21 représente une version et non une date ; il reflète toujours les dernières opérations d'API publiques disponibles.
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, assurez-vous de bien connaître sa version, son endpoint et sa 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 ses 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 obtenir une latence plus faible, utilisez également les 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 nécessaires 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. Il est fortement recommandé d'utiliser un utilisateur RAM pour les appels d'API et les opérations de maintenance courantes. 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é |
Support |
|
Pris en charge |
|
|
Utilisateur RAM (recommandé) |
Pris en charge |
|
Rôle RAM (recommandé) |
Pris en charge |
Informations complémentaires
Méthodes d'appel prises en charge
Utilisez l'une des méthodes suivantes pour appeler l'API ApsaraVideo VOD.
SDK Alibaba Cloud (recommandé)
Le SDK Alibaba Cloud constitue la méthode recommandée et la mieux prise en charge pour appeler les opérations OpenAPI. ApsaraVideo VOD fournit 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 de flux en direct vers VOD sans programmation complexe. Pour plus d'informations, consultez la rubrique SDK serveur.
Interface CLI Alibaba Cloud
L'interface CLI Alibaba Cloud vous permet de gérer les ressources cloud depuis un terminal de ligne de commande à l'aide de la commande aliyun. Pour plus d'informations, consultez la rubrique Présentation de l'interface 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. Cette approche 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 Corps de la requête V3 et mécanisme de signature.
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'ID de requête (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.