> For the complete documentation index, see [llms.txt](https://docs.fact-finder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fact-finder.com/integration/de/factfinder-search-integration/optional-interfaces.md).

# Optionale Schnittstellen

## Zusammenfassung

Dieser Artikel enthält Informationen über zusätzliche **optionale Schnittstellen** die verwendet werden können. Es ist nicht immer erforderlich, eine davon zu verwenden, aber in vielen Fällen ist es sinnvoll.

Dokumentation zu einzelnen FactFinder-Modulen (wie dem [Campaign Manager](/integration/de/campaign-specific-integration.md), oder dem [Recommendation Engine](/integration/de/recommendation-engine-integration.md)) ist in einzelnen Artikeln zu finden.

> Stellen Sie sicher, dass der Benutzer, den Sie für Authentifizierungszwecke beim Senden von Anfragen an diese Schnittstelle verwenden, die entsprechenden Rechte besitzt. Andernfalls erhalten Sie eine Fehlermeldung.

## Ändern, Löschen und Hinzufügen von Datensätzen / Delta-Updates

Diese Schnittstelle erlaubt es, einzelne oder mehrere Datensätze in der Suchdatenbank zu aktualisieren, zu löschen oder hinzuzufügen.

> Es ist jedoch zu beachten, dass Änderungen verloren gehen können, wenn ein Datenimport über diese Schnittstelle durchgeführt wird.

Als Grundlage des Imports dient immer der Produktdatenexport, den ein Shopsystem bereitstellt. Verwenden Sie diese Schnittstelle daher nur vorübergehend, um eine schnelle Korrektur eines Datensatzes vorzunehmen.

Alle Änderungen sind sofort in der Suche verfügbar. Durch Speichern der Datenbank werden die vorgenommenen Änderungen auf die Festplatte geschrieben, sodass die Änderungen auch nach einem Neustart verfügbar sind. Der Speichervorgang benötigt jedoch Rechenleistung, daher sollte er nicht bei jedem Änderungsaufruf durchgeführt werden.

> wichtig
>
> * Senden Sie nur Datenänderungen an FactFinder. Senden Sie keine Updates für Werte, bei denen keine Änderung stattgefunden hat.
> * Warten Sie Updates auf und senden Sie mehrere Updates in einer Anfrage. Massenaktualisierungen werden gegenüber mehreren kleineren Aktualisierungen bevorzugt.
> * Verwenden Sie Delta-Updates (also: Datensätze ändern, löschen und hinzufügen), um inkrementelle Änderungen an den bei FactFinder gespeicherten Daten vorzunehmen. Es wird empfohlen, zusätzlich einen täglichen `csv` Import bereitzustellen.

## Datenbanken aktualisieren

In den meisten Fällen verarbeitet FactFinder Datenaktualisierungen selbst. Je nach Definition des Aktualisierungsprozesses wird der Import jedoch nicht von FactFinder selbst initiiert, sondern über die Import-Schnittstelle. Dies ist besonders sinnvoll, wenn die Daten mittels Push-Methode bereitgestellt werden.

Wenn in der FactFinder-Suchkonfiguration eine URL hinterlegt ist, aus der die Exportdaten gezogen werden können, ist es möglich, diese vor dem Import herunterzuladen, sodass sie geladen werden können.

## REST-Schnittstelle

Die technische Dokumentation der REST-API befindet sich in der Suchanwendung selbst und kann über \[Ihr NG-Server]/fact-finder/swagger-ui.html aufgerufen werden. Sie ist außerdem über die folgende URL erreichbar:

Swagger-Link: <https://ng-demo.fact-finder.de/fact-finder/swagger-ui.html>

Methoden sind unter records dokumentiert. Zusätzlich zum Anzeigen der Parameterdokumentation können Sie auch eine Abfrage testen und die Ergebnisse anzeigen. Die Dokumentation wurde mit Swagger erstellt, sodass Sie Swagger Codegen verwenden können, um einen Client für die Nutzung in Ihrem Code zu generieren.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.fact-finder.com/integration/de/factfinder-search-integration/optional-interfaces.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
