PORTAL und PPS Knowledge Base
Medienstream API
Mithilfe der PEIQ Cloud-Connect APIs (engl. Application Programming Interfaces, Programmierschnittstellen) können Verlage Teile ihrer bestehenden Systeme und Produkte mit dem PEIQ PORTAL verbinden. Alle Cloud-Connect APIs sind nach der REST-Architektur aufgebaut. Der Zugriff wird dabei über die Standard-HTTP-Methoden GET, POST, PUT und DELETE gesteuert. Die Zugriffskontrolle erfolgt hierbei über eine Implementierung nach OAuth V2 Standard.
Über die Endpunkte der Medienstream API können die im PORTAL vorliegenden Medienstreams nach verschiedenen Filtern abgerufen, upgedatet oder gelöscht sowie neue Medienstreams angelegt werden.
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
sowieremote_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):
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
400
- Bad Request
Unter Umständen kann auch die Dubletten-Prüfung angeschlagen haben
404
- Not Found
Verwandte Seiten