Introduction
Vous pouvez faire plusieurs choses avec le Dynamic Ingest API, mais sa fonction principale est d’ajouter des vidéos à Video Cloud. Ce guide de démarrage rapide fournit un didacticiel simple pour vous aider à acquérir votre première vidéo à l’aide de l’API.
Ce didacticiel utilise l'outil de ligne de commande populaire appelé CURL pour effectuer des requêtes HTTP. Si vous n'êtes pas familier avec CURL, voir Configurer CURL. Notez que CURL est installé par défaut sur les systèmes Mac et Linux. Sous Windows, vous devez l'installer - les instructions figurent dans le guide Configuration de CURL.
Éscaliers
Obtenir les informations d'identification du client
Il s'agit d'une étape unique pour créer les informations d'identification du client pour les demandes d'API. Si vous disposez déjà des informations d'identification client nécessaires, vous pouvez ignorer cette étape.
-
Au Gestion des informations d'identification de l'API section de Studio.
- Cliquez Enregistrer une nouvelle application
-
Sélectionnez le ou les comptes appropriés et sélectionnez au moins ces autorisations:
- Création dynamique
- Profils d'ingestion Configuration Lu
- Profils d'ingestion lus
-
Copiez et enregistrez le identité du client et secret client qui sont créés (il n’ya aucun moyen de récupérer le secret du client une fois que vous fermez la boîte de dialogue!).
Obtenir le jeton OAuth
La client_id
et client_secret
sont utilisés comme nom d'utilisateur et mot de passe pour obtenir un jeton (authentification de base), utilisé pour authentifier les requêtes suivantes.
- Copiez le code ci-dessous dans un éditeur de texte et remplacez
CLIENT_ID
etCLIENT_SECRET
avec vos propres informations d'identification client:curl --request POST \ --url https://oauth.brightcove.com/v4/access_token \ --user CLIENT_ID:CLIENT_SECRET \ --header 'content-type: application/x-www-form-urlencoded' \ --data grant_type=client_credentials
Votre code va maintenant ressembler à quelque chose comme ça:
curl --request POST \ --url https://oauth.brightcove.com/v4/access_token \ --user 0072bebf-0616-442c-84de-7215bb176061:7M0vMete8vP_Dmb9o4a16iws4RQR74PO-JNDKkCOyXFkSIe_iRKdHiiNO6vuBWadn5xFw \ --header 'content-type: application/x-www-form-urlencoded' \ --data grant_type=client_credentials
- Copiez votre code modifié et collez-le dans le terminal (ou votre application de ligne de commande), appuyez sur Retour pour l'exécuter.
- La réponse devrait ressembler à ceci:
{ "access_token":"AMv4uy9puUMrSPtfOUo412Euy8gY1pcjv6RozlH9ALrHyekxY_u-83KWMECgigG9u_gSQoh_gpe8ChAQ1FHclNHgU4h_2qj-8ei19Ve-m4OJ2UOmJwJBZQht_6bIMJMZUZBIvIAGT-8av-uMOpqnnXVJ1qu2rPQeGraIjEkhTnXnGaa-RNUxisRkIoIktN1o9BFzrbLa1xstvPgVhdg78uVg8uDA8X0K9kfibxBfdIkDBzKJAViZZ3gQa56uit2r79GZ_t2KSUgLq1rOPsd0TflHwCAGtSaAHlvb44m-hUKFAOJa-FtXakQ72QcIXha5PhSjYTJZiUa4EbjxXpR6aLvPW4mGQcDzo8bQQ4Hnq8bsa_8l5eUjOm51WI96WhTPJCt4bBWVJKyLM8P7va_Ho6zJc2yOJHDamilRlyOS-DxN4U30m_2AxhHF3DKJO8fWl5srtpbZRPANOq5B6cpAkOiQafoXUv0ntP9nzRwyO-oXVvH4iLDTAArOTXPh-A7OD8QogWu9wb13vO48CvRPsGv9PfT4ZCxzUa3M2NXn8wontkSARzHVNqf6fh-iF6ifalPTw-Z9MhpPd-qwpcHbJfmu5EcJAR3K3QDYttjeRrmEvTBOgbQttapvI2h6rMQqgytiHXpxYgz3Hr1yKe1cuVI8z3haT5pb-FIfOfHKyr7vQ3RDXjdTTJZMYpOhKNjL0oEH2ev_bIGmbGnqUMcuAGhQgMiCVQUKwoLUGHTRG91ZWMCP7CfTEdcVc10jDSELcZ1SBig5_G42ymv1w3KauK6ZwE_Xmu4NrPZiPo-r3u_K08x8Rz8gS1b9mFtcPj6yux058WAW--HIoIQRFGeppiO3S6s1hzkU2jiKMGtTnB8X4MIJXLPq8LHcZO81appEzraHFUG5ewtKRTq5Ck6OFndlSmhT8KIKid806wI5b39eeoe-4c8Os23QuyWIQthG-YdcTSueNoqZ3-5e7HztoYbzNIKvtrdLpwgMAclD9fzs3oCclECAQaaLD3hWENE3n78_TzPt4OvQ4o8L17JTmozZYCq3VDnsp_M9Bb6az8mZfDX5_ALunsE65dv91aXFCjTJigVJ_r28k7kLVct-PVZ1XPSjdAyGoxttMeYpl24737aUZBqPAirHJK-griQlPBh04E0Ay5ip03gJvJxvGuzRE5r8hKD0lVQjfre9huiSjJX-xts4kbY", "token_type":"Bearer", "expires_in":300 }
- Notez que le
access_token
expire en minutes 5, mais vous pouvez réexécuter le code pour en obtenir un nouveau chaque fois que vous en avez besoin. Vous saurez que vous en avez besoin d’un nouveau si l’API demande, dans les étapes suivantes, de renvoyer uneUNAUTHORIZED
Erreur.
Créer une vidéo
Un appel au CMS API crée l'objet vidéo dans Video Cloud. Le corps de la demande stipule des métadonnées comme name
et description
. Le seul champ requis est le name
.
- Copiez le code suivant dans un éditeur de texte et remplacez
ACCOUNT_ID
avec votre propre Video Cloud identifiant de compte, etACCESS_TOKEN
avec le jeton de la réponse à la demande dans les étapes précédentes.curl --request POST \ --url https://cms.api.brightcove.com/v1/accounts/ACCOUNT_ID/videos/ \ --header 'authorization: Bearer ACCESS_TOKEN' \ --header 'content-type: application/json' \ --data '{"name": "My Video"}'
- La réponse JSON contiendra diverses métadonnées pour la vidéo, mais pour nos besoins, le champ important est en haut:
{ "id": "123456789001", … }
Vous utiliserez ceci
id
dans la demande d'ingestion ci-dessous pour laisser Video Cloud savoir à quelle vidéo associer votre fichier source vidéo.
Demande d'ingestion
Un appel à l’ingestion dynamique indique l’emplacement du fichier à ingérer.
- Copiez le code suivant dans un éditeur de texte et remplacez
ACCOUNT_ID
avec votre propre Video Cloud identifiant de compte,VIDEO_ID
desid
valeur renvoyée lors de la création de la vidéo, etACCESS_TOKEN
avec le jeton de la réponse à la demande dans les étapes précédentes.curl --request POST \ --url https://ingest.api.brightcove.com/v1/accounts/ACCOUNT_ID/videos/VIDEO_ID/ingest-requests \ --header 'authorization: Bearer ACCESS_TOKEN' \ --header 'content-type: application/json' \ --data '{ "master": { "url": "https://learning-services-media.brightcove.com/videos/mp4/Great_Blue_Heron.mp4" }, "callbacks": ["https://solutions.brightcove.com/bcls/di-api/di-callback-app.php"] }'
Notez que l'application vidéo et de rappel ici est fournie par Brightcove Learning Services à des fins de test. Vous pouvez les remplacer par des chemins d'accès à votre propre application vidéo et / ou de rappel. Si vous n'avez pas besoin de recevoir de notifications concernant le travail d'intégration, vous pouvez omettre le
callbacks
champ.Si vous utilisez notre application de rappel, vous pouvez voir les notifications. Cette application est utilisée pour les rappels par plusieurs autres applications. Utilisez donc l'ID de travail pour rechercher celles associées à votre travail.
- Vous devriez recevoir une réponse qui ressemble à ceci:
{"id":"bcc3dd36-50de-4343-b42a-ad02bd8f0241"}
- Vous devez enregistrer l'ID de travail car il est utile pour identifier les notifications associées à ce travail ou si vous devez contacter le support.
Si vous avez suivi les étapes ci-dessus avec succès, avez intégré une vidéo à votre compte à l'aide du logiciel Dynamic Ingest API. Si vous avez des problèmes ou des questions, n'hésitez pas à contacter Services d'apprentissage Brightcove de l'aide.
Si vous comptez beaucoup utiliser nos API, vous voudrez peut-être essayer d'autres outils de test que CURL: