Riverside Business API

« Riverside für Business Funktionen: Übersicht

Die Riverside Business API hilft, manuelle Anstrengungen zu sparen, indem sie deinem Team programmgesteuert ermöglicht, Aufnahmemedien aus deinem Riverside-Konto abzurufen und das zu löschen, was nicht mehr benötigt wird.

Das kann deine Post-Produktions-Workflows optimieren, Dir ermöglichen, Inhalte in großem Umfang zu verwalten, und die Sicherheit der langfristigen Speicherung deiner Daten verbessern. 

Über die API

Die Riverside Business API unterstützt:

Aufnahmen

  • Abrufen einer Liste von Produktionen mit zugehörigen Studios, Projekten und Aufnahmen.
  • Abrufen einer Liste von Aufnahmen mit optionaler Filterung nach Studio-ID oder Projekt-ID. Jede Aufnahme enthält Informationen über Spuren.
  • Abrufen einer einzelnen Aufnahme nach ihrer ID. Jede Aufnahme enthält Informationen über Spuren.
  • Herunterladen der Mediendatei einer Spur.
  • Herunterladen der Transkriptionsdatei einer Spur.
  • Löschen einer Aufnahme nach ihrer ID.

Bearbeitungen

  • Abrufen einer Liste von exportierten Bearbeitungen mit optionaler Filterung nach Studio-ID, Projekt-ID oder Aufnahme-ID.
  • Abrufen einer einzelnen exportierten Bearbeitung nach ihrer ID

  • Herunterladen der Mediendatei einer exportierten Bearbeitung

  • Löschen einer exportierten Bearbeitung nach ihrer ID

  • Eine Liste von Bearbeitungen in Deinem Arbeitsbereich abrufen, mit optionaler Filterung nach Studio, Projekt oder Datumsbereich, indem Du den List Edits-Endpunkt verwendest.

Exporte der Zeitleiste

  • Einen Timeline-Export für eine bestimmte Bearbeitung auslösen, indem Du den Create Timeline Export Endpunkt verwendest. 

  • Den Status eines Timeline-Exportjobs überprüfen und die Download-URL abrufen, indem Du den Get Timeline-Endpunkt verwendest. 

  • Eine ZIP-Datei herunterladen, die die Timeline-Datei (XML oder AAF) und alle zugeordneten Medien enthält, indem Du den Download Timeline File-Endpunkt verwendest.

Webinare

Aktuell unterstützt die Riverside Business API nicht:

  • Neue Funktionalitäten oder Apps entwickeln, die auf der Riverside-Plattform basieren (z. B. Integrationen und Apps).

API einrichten 

Sobald Deine CSM die Funktion aktiviert, folge den untenstehenden Schritten, um sie einzurichten.

Schritt für Schritt

  1. Melde Dich an bei Deinem Riverside-Konto.

  2. Klicke in der unteren linken Ecke auf den Konto-Menü.
  3. Klicke auf Einstellungen.
  4. Unter Team, klicke auf API.
  5. Unter API-Schlüssel generieren, klicke auf Generieren.
  6. Im Popup-Fenster, unter Dein API-Schlüssel, klicke auf Kopieren.
    Dein API-Schlüssel wurde in die Zwischenablage kopiert. 
    Sobald das Pop-up geschlossen ist, läuft der Schlüssel ab. Generiere jederzeit einen neuen Schlüssel.
  7. Folge der API Dev-Dokumentation hier.

Icon.svg Gut zu wissen

  • Du kannst nur 1 API-Schlüssel generieren und nur 1 API-Schlüssel kann gleichzeitig aktiv sein.
  • Das API-Zugriffslimit kann nicht geändert werden.
  • Die Business-API ruft Daten ab, wenn Du sie anforderst. Um Riverside Webinar-Ereignisse automatisch an Deine Tools zu senden, während sie stattfinden, verwende Webhooks.
  • Um deine Dateien in Google Drive zu speichern, verwende den Download-Datei-Endpunkt der API und richte dann Google's API ein, um die Dateien hochzuladen.