Allgemeines zu Zeitschriften
Es besteht die Möglichkeit zum Abrufen von Titelbildern, Preislisten-PDFs und Tarifdaten aus der Datenbank. Letztere lassen sich wahlweise als XML- oder JSON ausgeben, was über den 'Accept'-Header in der Anforderung gesteuert werden kann.
Zusätzlich gibt es nun die Möglichkeit, Daten gemäß dem OData-Protokoll abzurufen.
URL-Schema zum Abruf von Stammdaten
Es lassen sich nun unter api/v1.0/stammdaten/ zahlreiche Stammdaten abrufen.
Dazu gehören diverse Typen (für Adressen, Preise, Termine etc.) sowie Länder- und Regionalcodes.
Eine Authentifizierung ist hierfür nicht erforderlich.
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/verlage/{vid}/titel/{id}/preislisten/{nummer}
wobei die Verlags-ID {vid} und die Titel-ID {id} jeweils 6-stellige Integer-Zahlen und die Preislisten-Nummer als Zeichenkette erwartet wird. -
api/v1.0/verlage/
listet alle Verlage auf, für die der angemeldete Benutzer (Lese-)Berechtigung besitzt. Die Ausgabe kann durch Angabe eines Referenzdatums eingegrenzt werden. -
api/v1.0/verlage/746465[/titel/]
listet alle Titel des Verlages mit der ID 746465 auf, für die der angemeldete Benutzer (Lese-)Berechtigung besitzt. Die Ausgabe kann ebenfalls durch Angabe eines Referenzdatums eingegrenzt werden. -
api/v1.0/verlage/746465/titel/502889
listet alle Preislisten des Titels mit der ID 502889 auf. -
api/v1.0/verlage/768907/titel/516777/preislisten/15
liefert die angegebene Preisliste Nummer 15 des Titels mit der ID 516777 als XML- oder JSON-Dokument aus, wobei alle Teilbereiche eingeschlossen sind. -
api/v1.0/verlage/768907/titel/516777/preislisten/15/AnzeigenFormate
liefert nur die Anzeigenformate für die angegebene Preisliste Nummer 15 des Titels mit der ID 516777 als XML- oder JSON-Dokument aus.
Die möglichen Teilbereiche sind die untergeordneten Elemente der ersten Ebene im vollständigen Preislisten-Dokument und umfassen:- TitelKombiZugehoerigkeiten
- KombiBestandteile
- EVPreise
- HeftAngaben
- Bedingungen
- Auflagen
- RabattStaffeln
- Provisionen
- Skonti
- Bankverbindungen
- Adressen
- Preiszonen
- Hefte
- AnzeigenFormate
- AdSpecials
- Technik
URL-Schema zum Abruf von Titelbildern und Preislisten-PDFs
Folgende Url-Segmente für Titelbilder werden unterstützt:
-
api/v1.0/titelbilder/
Da es zu viele Titelbilder gibt, wird hier zwingend die Übergabe eines Referenzdatums vorausgesetzt, sonst wird Status-Code 400 zurückgegeben. -
api/v1.0/titelbilder/521018
Liefert das Titelbild für den Titel mit der ID 521018 zurück.
Folgende Url-Segmente für Preislisten-PDF's werden unterstützt:
-
api/v1.0/verlage/{vid}/titel/{id}/preislisten/{nummer}/pdf
Liefert das Preislisten-PDF zu einer bestimmten Preisliste zurück. -
api/v1.0/pdfchanged
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.