Immer öfter besteht der Bedarf andere Systeme mit den Daten im discoverize Portal zu verbinden. Wir haben in den letzten Wochen dafür verschiedene APIs fertiggestellt. Portalbetreiber können diese durch uns freischalten lassen und dann in ihrem Branchenportal nutzen. Dabei handelt es sich um APIs für Eintragsdaten, Bilder, Premium und einen WebHook zur Benachrichtigung wenn sich Eintragsdaten auf dem Portal geändert haben.
Hinweis: Diese APIs sind im Rahmen von Customizing für einen Kunden entwickelt worden und auch auf diesen Bedarf hin zugeschnitten. Wir haben die Schnittstellen mit Weitblick entwickelt, so dass sie für möglichst viele Szenarien einsetzbar sind. Im Detail werden aber je nach Einsatzgebiet noch Anpassungen notwendig werden.
Schnittstelle für Eintragsdaten
Eintragsdaten werden oft in anderen Systemen gebraucht, z.B. Buchungssystemen und Kundenmanagementsystemen. Die discoverize Plattformsoftware konzentriert sich auf Darstellung, Management und Buchung für Einträge – für andere Aspekte können andere Systeme besser geeignet sein. Um die Daten zwischen den Systemen aktuell zu halten haben wir eine REST-API entwickelt. Damit reduziert sich der händische Aufwand (durch Portal- oder Eintragsbetreiber) um die Daten an verschiedenen Stellen zu aktualisieren. Über die Schnittstelle können alle oder einzelne Einträge aus dem Portal abgerufen werden, einzelne Einträge im Portal angepasst werden oder Einträge im Portal erstellt werden. Weitere Informationen gibt es in der Dokumentation zur Eintrags-API. Es werden vorerst nur bestimmte Eigenschaftstypen unterstützt – diese werden aber in der Zukunft erweitert.
Bilderimport und -export
Mit dem Nutzen der Schnittstelle für Einträge können auch Bildimporte angestoßen werden. Das funktioniert analog zum Bilddownload via Import im Management. In der Dokumentation ist beschrieben wie die Bilddaten übertragen werden müssen. Beim Abrufen von Einträgen über die Schnittstelle werden derzeit die Daten der ersten 5 Bilder mit zurückgeben.
Schnittstelle zum Aktivieren und Deaktivieren von Premium
Es besteht nun eine rudimentäre Möglichkeit bei einzelnen Einträgen Premium zu aktivieren oder zu deaktivieren. Beim Aktivieren wird Premium analog zur manuellen Aktivierung durch den Portalbetreiber mit dem ersten Paket angeschaltet. Das Deaktivieren hat die gleichen Auswirkungen, als wenn der Portalbetreiber eine sofortige Stornierung von Premium für diesen Eintrag vornimmt.
WebHook bei Eintragsänderungen
Wenn das Trigger Changes Feature aktiviert ist, kann eine URL hinterlegt werden. Diese URL wird immer dann aufgerufen, wenn ein Eintrag im Management oder via Import geändert wird. Dem POST-Request werden die IDs der geänderten Einträge mitgegeben (bei einem Import können es mehrere sein).
Mehr Informationen gibt es in der Dokumentation unter API.
Hinterlasse eine Antwort