Medienstream API

Funktionalitäten der Medienstream API

• Abrufen von Medienstreams nach verschiedenen Filtern oder anhand der ID

• Erstellen, Editieren und Löschen von Medienstreams im PORTAL

Inhaltsverzeichnis

Allgemeine Beschreibung

Die Medienstream API ist der API Endpunkt der Medienstreams. Über die unten genannten Endpunkte können die im PORTAL vorliegenden Medienstreams nach verschiedenen Filtern abgerufen, upgedatet oder gelöscht sowie neue Medienstreams angelegt werden.

Verfügbare Endpunkte für Streaming Media

• GET /streamingmedia: Gibt eine paginierte Liste an Medienstreams nach den gesetzten Filtern aus.

• GET /streamingmedia/{streaming_media_id}: Gibt den durch die ID spezifizierten Medienstream zurück.

• POST /streamingmedia: Erstellt einen neuen Medienstream.

• PUT /streamingmedia/{streaming_media_id}: Aktualisiert die im Request Body angegebenen Informationen des durch die ID spezifizierten Medienstreams.
  plugin_type sowie remote_id können nicht aktualisiert werden!

• DELETE /streamingmedia/{streaming_media_id}: Löscht den durch die ID spezifizierten Medienstream unwiderruflich.

Dokumentation nach Open API Specification

Die API-Dokumentation ist als interaktive Dokumentation für berechtigte Admins direkt im jeweiligen PORTAL unter /admin/api/v2/doc?module=streaming_media erreichbar.

Das swagger-File kann auch hier heruntergeladen werden (Stand: Apr 27, 2022):

Open

Wichtige Hinweise zum Sync-Handling bei Upload-Plugins (z. B. JW-Upload-Plugin)

Die optional aktivierbaren Sync-Workflows (insbesondere bei Upload-Plugins im Falle von Bearbeitung, Re-Upload und Löschung über das User-Interface des PEIQ PORTALs) werden von der API nicht unterstützt und müssen vom über die API angebundenen Drittsystem gehandelt werden.

Über die Medienstream-API erstellten Medienstreams erhalten automatisch vom PORTAL ein flag sync_disable.

Trouble Shooting bei HTTP Status Codes

Verwandte Seiten

^{Nur für PEIQ-Mitarbeiter:innen}
https://peiq.atlassian.net/wiki/x/AQAnP