Integration über API (REST)

Die folgende Grafik zeigt die Integration über die API schematisch:

Vorbereitungen und Gestaltung

Die serverseitige Integration (Server-Skript) ist die Code-Schicht, die zwischen dem FactFinder Search Server und Ihren Zielseiten platziert wird. Sie steuert die Kommunikation zwischen beiden und muss vor einer API-Integration implementiert werden.

Die Schritte sind wie folgt:

1. Suchanfrage wird an FactFinder gesendet: Die vom Benutzer eingegebenen Suchparameter müssen per HTTP-Anfrage an den FactFinder Search Server übermittelt werden.

2. Suchergebnisse werden empfangen (Antwort): Der FactFinder Search Server liefert die Suchergebnisse über eine strukturierte Antwort (XML/JSON).

3. Suchergebnisse werden verarbeitet: Die zurückgegebenen Daten müssen vom Shop-System geparst werden.

4. Suchergebnis-Seite wird generiert (Anzeige): Die HTML-Struktur der Suchergebnis-Seite muss auf den gelieferten Suchergebnisinformationen basieren.

Der wichtigste Unterschied zwischen dieser Methode und dem Web Components-Ergebnis besteht darin, dass das Design der Suchergebnis-Seite vom Shop erstellt wird. Auf diese Weise wird das Design zentral verwaltet und muss nicht an mehreren Stellen überwacht und korrigiert werden.

Integrationsmöglichkeiten

Die Integration über die API gibt es in zwei Varianten:

1. Entwickeln Sie den Integrationscode von Grund auf neu. Alle notwendigen Informationen finden Sie auf Ihrer Swagger UI-Seite: https://[Ihr FactFinder-Setup hier]/FactFinder/swagger-ui.html. Demos und Beispiele finden Sie auf GitHub.

2. Verwenden Sie Swagger Codegen. Klassen wie SearchRequest, SearchParamsund TrackingApi werden automatisch generiert, was Ihren Integrationscode vereinfacht. Erfahren Sie hier mehr: Wie man Swagger Codegen für die Integration über die API verwendet