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.
Mit der Aktionen API können alle Aktionsformen angelegt, editiert und gelöscht werden. Zudem können Sie Aktionen Bild-Assets abrufen und hinzufügen, oder Teilnehmer:innen-Informationen abrufen, hinzufügen und entfernen.
Funktionalitäten der Aktionen API
Aktionsformen angelegen, editieren und löschen
Aktionen Bild-Assets abrufen und hinzufügen
Teilnehmer:innen-Informationen abrufen, hinzufügen und entfernen
Inhaltsverzeichnis
Allgemeine Beschreibung
Mit der Aktionen API können externe Systeme die Aktionsformen Verlosung , Umfrage , Frage beantworten , Fotowettbewerb und Texteinsendung anlegen, editieren und löschen, sowie relevante Informationen über diese Aktionen abrufen.
Anlegen, editieren und löschen von Aktionsformen
Alle Aktionsformen des PEIQ PORTALs, inkl. dafür notwendiger Inhalte, Laufzeiten, Pflichtfelder und Bestätigungsfelder, können über die Aktionen-API angelegt, editiert und gelöscht werden.
Informationsabruf angelegter Aktionen
Über die Aktionen-API können die ID und weitere Informationen jeder angelegten Aktion abgerufen werden.
Teilnehmer-Informationen an Aktionsformen aktualisieren
Teilnehmer-Informationen an einer Aktionsform des PEIQ PORTALs können hinzugefügt, gelöscht oder abgerufen werden. Enthält die Aktionsform auch ein Bild-Asset, wird dieses direkt mit der Teilnahme hinzugefügt oder gelöscht.
Open API Specification
Die API-Dokumentation ist als interaktive Dokumentation für berechtigte Admins direkt im jeweiligen PORTAL unter /admin/api/v2/doc?module=participation erreichbar.
Verfügbare Endpunkte
Participation Event
GET /participation/events: Gibt eine paginierte Liste an Aktionsformen nach den gesetzten Filtern aus.
GET /participation/events/{event_id}: Gibt eine durch die ID spezifizierte Aktionsform zurück.
POST /participation/events: Erstellt eine neue Aktionsform.
PUT /participation/events/{event_id}: Aktualisiert die im Request Body angegebenen Informationen der durch die ID spezifizierten Aktionsform.
DELETE /participation/events/{event_id}: Löscht die durch die ID spezifizierte Aktionsform unwiderruflich.
Participation User Entry
GET /participation/events/{event_id}/userentries: Gibt die Teilnehmerinformationen der durch die ID spezifizierten Aktionsform zurück.
POST /participation/events/{event_id}/userentries: Erstellt eine neue Teilnehmerinformation für eine durch die ID spezifizierte Aktionsform.
DELETE /participation/userentries/{user_entry_id}: Löscht eine durch die ID spezifizierte Teilnehmerinformation.
Verwandte Seiten
Disclaimer
Für die vorliegende Systemübersicht/Publikation behalten wir uns alle Rechte vor. Nachdruck, Vervielfältigung und Verbreitung (auch auszugsweise) ist nur mit schriftlicher Genehmigung der PEIQ Publishing GmbH & Co. KG erlaubt. Wir behalten uns vor, die Systemübersicht/Publikation jederzeit ohne vorherige Ankündigung zu ändern und/oder zu erweitern. Die vorliegenden Angaben dienen lediglich Informationszwecken. Die PEIQ Publishing GmbH & Co. KG übernimmt keinerlei Haftung und/oder Garantie für Fehler und/oder unvollständige Angaben in der Systemübersicht/Publikation, mit Ausnahme von vorsätzlich falschen oder arglistig verschwiegenen Angaben. Da unsere Software laufend weiter entwickelt wird, handelt es sich bei den vorliegenden nur um allgemeine Angaben. Es handelt sich weder um eine Zusicherung von Mindestvertragsinhalten, noch um Beschaffenheitsgarantien im Sinne des § 443 BGB.
Nur für PEIQ-Mitarbeiter: