Allgemeines zu den Online/Mobile/Apps-Medien.
Es besteht die Möglichkeit zum Abrufen der Tarifdaten aus der Datenbank. Sie lassen sich wahlweise als XML- oder JSON ausgeben, was über den 'Accept'-Header in der Anforderung gesteuert werden kann.
URL-Schema zum Abruf von Verlagen, Titel und Preislisten
Generell lassen sich jeweils alle - oder nur die seit einem bestimmten Datum geänderten - untergeordneten Objektverweise abrufen.
Zur Definition des Referenzdatums wird der Header 'If-Modified-Since' verwendet.
Folgende Url-Segmente werden unterstützt:
-
api/v1.0/onlinevermarkter/
listet alle Vermarkter auf, für die der angemeldete Benutzer (Lese-)Berechtigung besitzt. Die Ausgabe kann durch Angabe eines Referenzdatums (If-Modified_Since) eingegrenzt werden. -
api/v1.0/onlinevermarkter/800117[/gesamtangebote/]
listet alle Gesamtangebote (Sites) des Vermarkters mit der ID 800117 (TOMORROW FOCUS MEDIA GmbH) auf, für die der angemeldete Benutzer (Lese-)Berechtigung besitzt. Die Ausgabe kann ebenfalls durch Angabe eines Referenzdatums (If-Modified_Since) eingegrenzt werden. -
api/v1.0/onlinevermarkter/800117/gesamtangebote/4007671-20120503
liefert die Tarifdaten aller Belegungseinheiten des Gesamtangebotes mit der ID 4007671-20120503 auf, für die der angemeldete Benutzer (Lese-)Berechtigung besitzt.
URL-Schema zum Abruf von Titelbildern und Preislisten-PDFs
Folgende Url-Segmente für Titelbilder werden unterstützt:
-
api/v1.0/titelbilderonline/
Diese Funktion ist noch nicht implementiert.
Da es zu viele Titelbilder gibt, wird hier zwingend die Übergabe eines Referenzdatums vorausgesetzt, sonst wird Status-Code 400 zurückgegeben. -
api/v1.0/titelbilderonline/4001699
Liefert das Titelbild für den Titel mit der ID 4001699 zurück.
Folgende Url-Segmente für Preislisten-PDF's werden unterstützt:
-
api/v1.0/onlinevermarkter/{vid}/gesamtangebote/{id}/pdf
Liefert das Preislisten-PDF für das angegebene Gesamtangebot zurück. -
api/v1.0/pdfchangedonline
Da es zu viele Preislisten-PDF's gibt, wird hier zwingend die Übergabe eines Referenzdatums vorausgesetzt, sonst wird Status-Code 400 zurückgegeben.
Liefert alle Preislisten-PDF's zurück, die sich seit dem Referenzdatum [If-Modified-Since] geändert haben.