Übungsgebiet: API für Ingest-Profile

In diesem Thema erfahren Sie, wie Sie die Ingest Profiles API verwenden, um Ingest- und Transcode-Profile für Ihr Konto zu verwalten. Im Übungsbereich können Sie verschiedene API-Anfragen auf Ihrem eigenen Konto oder einem Brightcove-Beispielkonto ausprobieren.

Einleitung

Die Ingest Profiles API ermöglicht Ihnen:

  • Holen Sie sich die Profile für Ihr Konto

  • Neue Profile erstellen

  • Profile aktualisieren

  • Profile löschen

  • Legen Sie das Standardprofil für Ihr Konto fest oder aktualisieren Sie es

Eine erholsame API

Die Ingest-Profile-API ist eine RESTful-API. Es akzeptiert HTTPS-Anfragen und gibt eine JSON-Antwort zurück.

Dies bedeutet, dass Sie die API mit jeder beliebigen Sprache verwenden können – Ruby, Java, PHP, Python, JavaScript (über AJAX oder nodejs) usw. Alles, was Sie tun müssen, ist HTTPS-Anfragen zu stellen und eine JSON-Antwort zu verarbeiten.

Berechtigung abrufen

So verwenden Sie die CMS API Sie benötigen die richtigen Anmeldeinformationen.

Der einfachste Weg, um Anmeldeinformationen zu erhalten, ist in den meisten Fällen der Abschnitt Studio-Admin-API-Authentifizierung (erfordert Administratorberechtigungen für Ihr Konto). Sehen Verwalten von Anmeldeinformationen für die API-Authentifizierung für Details. In den meisten Fällen möchten Sie wahrscheinlich nur Berechtigungen für alle Vorgänge der Ingest Profiles API erhalten:

Ingest Profiles API-Berechtigungen
Ingest Profiles API-Berechtigungen

Wenn die benötigten Berechtigungen in Studio nicht verfügbar sind oder wenn Sie sie lieber direkt von der OAuth-API erhalten möchten, verwenden Sie Ihre Wahl aus der Erhalten Sie Client-Anmeldeinformationen unten aufgeführten Dokumente. Für welche Option Sie sich auch entscheiden, Sie müssen nach den richtigen Betriebsberechtigungen fragen. Folgendes kann mit cURL oder Postman verwendet werden, um alle Berechtigungen für die Ingest Profiles API zu erhalten:

  "operations": [
    "video-cloud/ingest-profiles/profile/read",
    "video-cloud/ingest-profiles/profile/write",
    "video-cloud/ingest-profiles/account/read",
    "video-cloud/ingest-profiles/account/write"
  ]

Schnellstart-App

Suchen Sie den gesamten Code, der mit diesem Beispiel verknüpft ist, in diesem GitHub-Repository.

Siehe den Stift Schnellstart: API für die Aufnahme von Profilen (Dynamic Delivery) von Brightcove Learning Services (@rcrooks1969) auf CodePen.

CodePen verwenden

Hier sind einige Tipps zur effektiven Verwendung des obigen CodePen:

  • Schalten Sie die aktuelle Anzeige des Players um, indem Sie auf klicken Ergebnis Taste.
  • Drücke den HTML/CSS/JS Tasten, um EINEN der Codetypen anzuzeigen.
  • Klicken Auf CodePen bearbeiten in der oberen rechten Ecke, um diesen CodePen Ihrem eigenen Konto zuzuordnen.
  • Suchen Sie den gesamten Code, der mit diesem Beispiel verknüpft ist, in diesem GitHub-Repository.

Proxy-Code

Um Ihre eigene Version der Beispiel-App auf dieser Seite zu erstellen, müssen Sie Ihren eigenen Proxy erstellen und hosten. (Die von Brightcove Learning Services verwendeten Proxys akzeptieren nur Anfragen von Brightcove-Domains.) Ein Beispielproxy, der dem von uns verwendeten sehr ähnlich ist, aber ohne die Prüfungen, die Anfragen von Nicht-BrightCove-Domänen blockieren, kann in diesem GitHub-Repository gefunden werden. Dort finden Sie auch grundlegende Anweisungen zur Verwendung und eine ausführlichere Anleitung zum Erstellen von Apps rund um den Proxy unter Verwenden der REST-APIs.