# Integration über API (REST)

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

![](https://3134803627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQMmNfppEDkleiziCG4Gp%2Fuploads%2Fgit-blob-39c42a77094ce4fbf86db84b82fc6b1a0dcd3803%2FIntegration-20via-20API-4.png?alt=media)

## 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](https://github.com/fact-finder).
2. Verwenden Sie **Swagger Codegen**. Klassen wie `SearchRequest`, `SearchParams`und `TrackingApi` werden automatisch generiert, was Ihren Integrationscode vereinfacht. Erfahren Sie hier mehr: [Wie man Swagger Codegen für die Integration über die API verwendet](https://docs.fact-finder.com/integration/de/factfinder-search-integration/integrating-the-search-into-the-shop-system/how-to-use-swagger-codegen-for-the-integration-via-api)