...
Ein voll funktionsfähiges Beispiel in Form eines Java-Programms, das den Veranstaltungskalender über die private-API ausliest ist verfügbar. Dort verwendete Basisklassen sind ebenfalls dokumentiert.
Eine Implementierung in PHP unter Verwendung der CURL-Bibliothek.
Die publicAPI stellt dagegen alle öffentlich zugänglichen Informationen des Stattreisenanbieters zur Verfügung. Hier ist insbesondere das aktuelle Programm in Listen- oder Kalenderform zu nennen. Diese API kann sowohl von den Stattreiseanbietern selber genutzt werdne, um aktuelle Daten in ihren eigenen Webauftritt einzubinden, als auch von Dritten, z.B. eigenständige Vorverkaufsstellen.
Folgende Standards gelten für beide APIs:
- Der Aufruf erfolgt ausschließlich über https. Ein Zugriff auf Ressourcen mit http ist nicht möglich.
- Die Payload im Postbody sowie alle Rückgabewerte sind immer im JSON-Format.
- Zeichenkodierung ist immer UTF-8
...
- Datum, Zeit und Zeitstempel werden im JSON immer gemäß ISO 8601 formatiert. Die Angabe der Zeitzone ist optional, wird im Allgemeinen aber nicht genutzt