Seminar-Shop Schnittstelle für Partner
Allgemein
Die Schnittstelle wird über HTTP GET Requests angesprochen und liefert alle Seminar Termine, die im Seminarshop von Software Quality Lab Academy verfügbar sind als JSON codierte Antwort.
Sobald ein Termin gelöscht wurde oder das Seminar bereits durchgeführt wurde ist der Termin nicht mehr im Export enthalten.
Aufbau und Paramater
URL für die Schnittstelle zum Abholen der Software Quality Lab Academy Seminartermine: https://www.software-quality-lab.com/seminardate-export?tx_rxseminars_seminars[action]=jsonList&partner=FIRMAX
Parameter: partner
Der Shop von Software Quality Lab Academy erkennt durch einen Aufruf dieses Links, dass ein Seminar-Buchender über eine Partner Seite auf das Seminar aufmerksam wurde, wenn der Partner-Parameter entsprechend gesetzt wurde.
Dazu ist es notwendig, dass die URL zum jeweilgen Seminar-Termin einen Partner-Parameter enthält.
Die Schnittstelle erzeugt die Links richtig, wenn der gewünschte Partner Parameter beim GET Request angefügt wird.
Bitte verwenden sie einen Namen für den Parameter, der Ihre Firma entsprechend kennzeichnet und nur aus Buchstaben, Ziffern, Bindestrichen oder Unterstrichen besteht.
Verwenden Sie bitte für alle Partner-Links denselben Parameter.
Der Partner-Link zu einem Seminartermin kann auch manuell erstellt werden, ohne die gesamten Seminardaten über die JSON Schnittstelle abzuholen (z.B. wenn auf der Partner-Website nur der Seminartitel angegeben und auf die Software Quality Lab Website verlinkt werden soll).
Dazu muss die Termin URL einfach um den Parameter ergänzt werden. z.B.:
Der Seminar-Link https://software-quality-lab.com/leistungen/academy/seminartermine/seminar/titel/ muss dann mit dem "partner"-Parameter ergänzt werden
und wird zu https://software-quality-lab.com/leistungen/academy/seminartermine/seminar/titel/?partner=testpartner
JSON Format
Alle Termine sind in einer Liste angeführt und haben folgendes Format:
"[unique_id]": {
"status": "[undecided|confirmed|canceled]",
"title": "Seminar Titel",
"description": "<p>HTML Beschreibung</p>",
"price_seminar": {
"[EUR|CHF]": [integer]
},
"price_exam": {
"[EUR|CHF]": [integer]
},
"seats_available": [true|false],
"date_from": "YYYY-MM-DD",
"date_to": "YYYY-MM-DD",
"time_schedule": "09:00 - 17:00",
"address_1": "Firma",
"address_2": "Straße",
"city": "Stadt",
"zip_code": "PLZ",
"country": "[Österreich|Deutschland|Schweiz]",
"language": "[de|en]",
"product_type": "seminar",
"date_created": "2018-08-16T13:33:20+02:00",
"date_updated": "2019-02-07T10:05:37+01:00",
"url": "https:\/\/software-quality-lab.com\/leistungen\/academy\/seminartermine\/seminar\/titel\/?partner=testpartner"
}
Anmerkungen
- unique_id ändert sich für einen Termin nicht
- status ist initial "undecided". Wenn es genügend Anmeldungen gibt wird ein Termin "confirmed" und findet dann sicher statt. Gibt es nicht genügend Anmeldungen wird der Termin abgesagt und hat dann den Status "canceled"
- seats_available: Sobald ein Termin ausgebucht ist wird dieser Wert false
- date_from und date_to: Datum des Termins
- time_schedule: Enthält Zeitinformationen wann der Termin ist
- address_1 und address_2: Teilweise sind Firmenname und Straße nur in address_1 enthalten
- price_exam ist nur verfügbar wenn es eine Prüfung gibt
- product_type ist derzeit immer seminar
- date_created ist der Zeitpunkt bei dem das Seminar erstellt wurde (im Format ISO 8601)
- date_updated ist der Zeitpunkt bei dem das Seminar zuletzt bearbeitet wurde (im Format ISO 8601)