REST API für OTT: Katalog automatisieren

Artwork und Live-Kanäle per API

Über die Vodlix API wird Artwork per URL zugewiesen statt von Hand hochgeladen. Ein Aufruf legt Hochformat-, Querformat- und Logobilder eines Titels fest, ein weiterer wählt aus, welcher generierte Frame als Thumbnail dient. Live-Kanäle werden wie Videos behandelt: aus einer Stream-URL erstellt, aktualisiert, veröffentlicht oder zurückgezogen sowie in den Papierkorb verschoben oder wiederhergestellt – so werden lineare Inhalte genauso automatisiert wie On-Demand-Inhalte. Bei einem großen oder sich häufig ändernden Katalog bleibt das Artwork so einheitlich, ohne dass jemand Dateien einzeln hochladen muss.

REST API

Vertraut und berechenbar.

Bildet den Admin ab

Wer die Oberfläche kennt, kennt die API.

Kompletter Lebenszyklus

Erstellen, veröffentlichen, zurückziehen, wiederherstellen.

Den Katalog programmgesteuert verwalten

Mit der Vodlix REST API steuern Sie den Katalog programmgesteuert, genau wie im Admin-Bereich. Videos lassen sich erstellen, aktualisieren, veröffentlichen oder zurückziehen sowie in den Papierkorb verschieben oder wiederherstellen. Serien und Staffeln werden auf dieselbe Weise erstellt, aktualisiert und veröffentlicht, und Episoden werden einer Staffel zugeordnet oder von ihr gelöst. Neue Videos werden aufgenommen, indem Sie der Plattform eine Datei-URL übergeben – öffentlich oder in Ihrem eigenen S3- oder Wasabi-Speicher: Sie ruft die Datei ab, verarbeitet sie im Hintergrund und gibt eine Video-ID zurück, über die Sie den Vorgang verfolgen. Für OTT-Betreiber mit bestehenden Systemen lässt sich die Katalogverwaltung automatisieren, statt sie von Hand zu erledigen.

API-Dokumentation für „Upload with URL“, das ein Video über eine Datei-URL aus öffentlichem, S3- oder Wasabi-Speicher aufnimmt

Startseite des Storefronts mit den Reihen „Top 10“ und „Rent the Latest“ – Content-Listen, die sich per API-Aufruf ein- und ausschalten lassen

Merchandising und Content-Listen unter API-Kontrolle

Die Vodlix API gibt Ihnen die Kontrolle über das Merchandising: Content-Listen, Listengruppen, deren Elemente und ihre Reihenfolge lassen sich programmgesteuert erstellen und verwalten. Listen können aktiviert und deaktiviert werden, sodass eine saisonale Reihe per API-Aufruf abgeschaltet statt neu aufgebaut wird. So können Planungssysteme und Tools zur Inhaltsplanung die Startseite automatisch gestalten. Erst Merchandising unter API-Kontrolle lässt redaktionelle Workflows skalieren.

Referenz- und Reporting-Endpunkte

Die Vodlix API bietet Referenz- und Reporting-Aufrufe: Kategorie-IDs, Katalog- und Nutzerzahlen, eine Umsatzübersicht für jeden beliebigen Zeitraum sowie Plattformdetails wie die Softwareversion. Integrationen wissen immer, womit sie arbeiten, und können sich an Änderungen der Plattform anpassen. Der Zugriff erfolgt über API-Schlüssel, die im Admin erstellt werden: ein Server-Schlüssel für Back-End-Jobs und ein Client-Schlüssel für Browser-Code, der niemals Admin-Routen erreichen kann. Dieselben Aufrufe stehen KI-Assistenten über den MCP-Connector der Plattform zur Verfügung.

Tabelle der MCP-Access-Tools mit Plattforminfos, Inhalts- und Nutzerzahlen, Katalogsuche und einer Umsatzübersicht

Wo sie sich in der Regel bezahlt macht

Die typischen Fälle sind Migration, Ingest und Reporting. Der Umzug eines Katalogs von einer anderen Plattform ist eine API-Aufgabe statt manueller Arbeit – und genau das unterscheidet einen Launch, der auf niemanden wartet, von einem, der Monate dauert. Wiederkehrender Ingest von einem Distributor oder aus einem Produktions-Workflow läuft unbeaufsichtigt, sobald er einmal geschrieben ist. Das Reporting überträgt Kennzahlen in die Tools, die Ihr Finanzteam ohnehin nutzt, statt jemanden jeden Montag einen Bildschirm exportieren zu lassen.

Außerdem verbindet sie Ihre Plattform mit dem Rest Ihres Unternehmens. Übertragen Sie einen neuen Titel in dem Moment, in dem er veröffentlicht wird, in Ihr CMS und auf Ihre Marketing-Website, oder übergeben Sie Ihre Content-Listen an einen Empfehlungsdienst und schreiben Sie die Ergebnisse zurück. Braucht eine Integration mehr, als die API allein bietet, entwickelt unser Service für individuelle Plugins das fehlende Stück auf derselben Plattform.

Analysen sind über die API verfügbar, sofern in Ihrer Cloud ein Statistikdienst konfiguriert ist. Das sollten Sie schon bei der Einrichtung klären, statt es erst später festzustellen. Was genau gemessen wird, erfahren Sie auf der Seite Berichte und Analysen.

Häufig gestellte Fragen

Haben Sie Fragen zur Inanspruchnahme dieses zeitlich begrenzten Angebots? Schauen Sie sich die FAQ für Antworten an.

Was kann die Vodlix REST API steuern?

Die Vodlix REST API steuert den Katalog – darunter Videos, Serien, Staffeln und Episoden – sowie Artwork, Live-Kanäle, Content-Listen und Merchandising und außerdem Referenz- und Reporting-Daten.

Lade ich Videodateien über die Vodlix API hoch?

Neue Videos werden über die Vodlix API aufgenommen, indem Sie eine öffentliche HTTPS-URL angeben. Vodlix ruft die Datei ab und transkodiert sie, sodass Sie keine binären Uploads über Ihre eigene Infrastruktur streamen müssen.

Entspricht die Vodlix API dem Admin-Bereich?

Ja. Die Vodlix REST API bildet den Admin-Bereich ab, mit vertrauten REST-Konventionen und vorhersehbaren Antworten. Wer die Oberfläche kennt, weiß also ungefähr, was die API kann.

Kann ich Content-Listen über die Vodlix API verwalten?

Ja. Vodlix Content-Listen, Listengruppen, ihre Elemente und ihre Reihenfolge lassen sich über die API erstellen, aktualisieren, aktivieren und deaktivieren, sodass sich das Merchandising automatisieren lässt.

Welche Reporting-Daten liefert die Vodlix API?

Die Vodlix API liefert Katalog- und Nutzerzahlen, eine Umsatzübersicht für einen Zeitraum, Kategorie-IDs und Plattformdetails wie die Softwareversion, sodass Integrationen immer wissen, womit sie arbeiten.

Sind die Kategorie-IDs in jeder Vodlix-Cloud gleich?

Nein, und genau hier passieren die meisten Fehler. Kategorien gelten pro Cloud. Lesen Sie daher die Kategorienliste der Plattform aus, mit der Sie arbeiten, und verwenden Sie die zurückgegebenen IDs, statt anzunehmen, dass ein Name überall derselben Nummer entspricht.

Können wir Analysen über die API abrufen?

Ja, sofern in Ihrer Cloud ein Statistikdienst konfiguriert ist – mit den wichtigsten Kennzahlen, Echtzeitaktivität und den erfolgreichsten Inhalten. Das sollten Sie bei der Einrichtung klären, denn der Dienst wird getrennt von den Katalogfunktionen bereitgestellt.

Eignet sich die API für die Migration von einer anderen Plattform?

Das ist einer der häufigsten Gründe, warum Betreiber sie nutzen. Wird ein Katalog programmgesteuert übertragen, wird aus einer Migration ein wiederholbarer Vorgang statt monatelanger manueller Eingabe – und er lässt sich erneut ausführen, um alles zu erfassen, was sich während des Umzugs geändert hat.

Wie authentifizieren sich Integrationen bei der Vodlix API?

Mit einem API-Schlüssel, der im Admin unter „Apps & APIs“ erstellt und im Header X-Api-Key gesendet wird. Ein Server-Schlüssel handelt mit den Berechtigungen des Nutzers, dem er gehört, und kann Admin-Routen erreichen – er gehört daher in ein Back-End. Ein Client-Schlüssel ist für Browser-Code sicher und von allen Admin-Routen ausgeschlossen. Schlüssel können ein Ablaufdatum haben, und das Löschen eines Schlüssels widerruft ihn sofort.

REST API für Ihre Streaming-Plattform