Entwicklung einer Such-API und eines einbettbaren Widgets für Farnall

Farnall wollte, dass ihre Produktsuche auf den Websites anderer funktioniert. Wir haben eine API gebaut, die ein eigenständiges Iframe-Widget antreibt und Partnern eine voll funktionsfähige Sucherfahrung bietet, ohne die zugrunde liegenden Daten oder Systeme offenzulegen.

Farnall · Individualsoftware · API-Entwicklung · Iframe-Integration

Suche, die überall lebt

Farnall brauchte eine Möglichkeit, Partner-Websites eine Produktsuche anzubieten, ohne ihren Katalog preiszugeben oder von Partnern zu verlangen, etwas zu entwickeln.

Der Produktkatalog von Farnall ist das Herzstck ihres Geschäfts. Partner und Wiederverkäufer mussten regelmässig Produkte suchen und referenzieren, aber ihnen direkten Zugang zu internen Systemen zu geben, war nicht praktikabel. Sie brauchten etwas, das sich in die Website eines Partners einfügen und nativ anfühlen konnte, während Farnall die volle Kontrolle über Daten und Darstellung behielt.

Die Lösung musste für Partner einfach zu übernehmen sein. Keine SDKs, keine API-Keys auf deren Seite, kein Frontend-Code zum Schreiben. Nur ein einziges Iframe-Embed, das Besuchern Zugang zu Farnalls Suchfunktionalität gibt.

Auf Farnalls Seite mussten sie kontrollieren können, welche Domains das Widget einbetten dürfen, welche Produktkategorien pro Partner sichtbar sind und wie Ergebnisse dargestellt werden. Die API musste der zentrale Kontrollpunkt für all das sein.

  • Suche muss in der Partner-Website leben

    Farnall brauchte ihre Produktsuche nahtlos innerhalb von Drittanbieter-Websites über ein Iframe, ohne dass diese Partner Zugang zur zugrunde liegenden Dateninfrastruktur benötigen.

  • Kontrollierter Zugang zu Produktdaten

    Die API musste Suchergebnisse nur an autorisierte Iframes liefern. Partner betten das Such-Widget ein, aber Farnall behält die volle Kontrolle darüber, welche Daten exponiert werden und wie sie dargestellt werden.

  • Schnelle, relevante Ergebnisse

    Endnutzer, die innerhalb des eingebetteten Widgets suchen, erwarteten sofortige, präzise Ergebnisse. Die API musste Filterung, Keyword-Matching und Kategorienavigation ohne spürbare Verzögerung bewältigen.

Ein Endpunkt, volle Kontrolle

Wir haben eine Such-API gebaut, die Farnall besitzt und betreibt. Sie treibt jedes eingebettete Widget an, verwaltet die Zugriffskontrolle und liefert Ergebnisse aus einer einzigen Datenquelle.

  • RESTful-Such-Endpunkt

    Eine saubere, dokumentierte API, die Suchanfragen, Filter und Paginierungsparameter akzeptiert. Liefert strukturiertes JSON, das das Iframe-Frontend direkt konsumiert.

  • Einbettbares Iframe-Widget

    Eine eigenständige Suchoberfläche, die per einzelnem Iframe-Tag in jede Website eingefügt werden kann. Verwaltet eigenes Styling, Paginierung und Ergebnisanzeige, ohne in die Host-Seite überzugreifen.

  • Herkunftsbasierte Zugriffskontrolle

    Die API validiert Anfragen gegen eine Whitelist genehmigter Domains. Nicht autorisierte Quellen erhalten keine Daten, wodurch Farnalls Produktkatalog geschützt bleibt.

  • Konfigurierbares Suchverhalten

    Partner können Parameter übergeben, um zu steuern, welche Produktkategorien angezeigt werden, wie Ergebnisse sortiert werden und ob bestimmte Filter in ihrer eingebetteten Instanz sichtbar oder verborgen sind.

Vom Einbetten zum Ergebnis in Millisekunden

  1. 01

    Partner bettet das Iframe ein

    Eine einzige Zeile HTML ist alles, was der Partner braucht. Das Iframe-Tag verweist auf Farnalls gehostetes Such-Widget, mit optionalen Parametern für Kategoriefilterung und Darstellungspräferenzen.

  2. 02

    Nutzer sucht im Widget

    Besucher auf der Partner-Website geben eine Suchanfrage ein oder durchstöbern Kategorien. Das Frontend des Iframes sendet Anfragen an die Farnall-Such-API und übergibt die Domain des Partners zur Validierung.

  3. 03

    API liefert gefilterte Ergebnisse

    Die API prüft die anfragende Herkunft, führt die Abfrage gegen Farnalls Produktindex aus und liefert strukturierte Ergebnisse. Das Iframe rendert sie sofort ohne Seitenneuladung.

  4. 04

    Farnall behält die Kontrolle

    Produktdaten, Suchlogik und Zugriffsberechtigungen leben alle auf Farnalls Infrastruktur. Partner erhalten eine ausgefeilte Sucherfahrung, ohne jemals das zugrunde liegende System zu berühren.

Eine Zeile HTML, volle Sucherfahrung

Partner fügen ein einziges Iframe-Tag in ihre Seite ein. Alles andere wird vom Widget und der dahinterliegenden API erledigt.

Das Iframe-Widget ist eine eigenständige SvelteKit-Anwendung, die ausschliesslich mit der Farnall-Such-API kommuniziert. Es rendert eigene Suchleiste, Filter, Ergebnisraster und Produktdetailansichten vollständig innerhalb der Iframe-Grenze.

Da das Widget eigenständig ist, greift es nie in die Styles oder Skripte der Host-Seite ein. Partner müssen sich keine Sorgen über CSS-Konflikte, JavaScript-Kollisionen oder Layout-Probleme machen. Das Widget passt sich an jede Containerbreite an.

Aus Nutzersicht fühlt sich die Suche wie ein nativer Bestandteil der Partner-Website an. Man gibt eine Suchanfrage ein, durchstobert Ergebnisse und sieht Produktdetails, ohne die Seite jemals zu verlassen.

Widget-Funktionen

  • Responsives Layout, das sich an die Containerbreite der Host-Seite anpasst
  • Keyword-Suche mit sofortiger Filterung
  • Eingrenzung nach Kategorie und Attributen
  • Paginierte Ergebnisse mit konfigurierbarer Seitengrösse
  • Produktdetailansichten ohne Verlassen des Iframes
  • Gebrandet im visuellen Stil von Farnall

Brauchen Sie eine API oder ein einbettbares Widget?

Wir bauen APIs, Suchsysteme und White-Label-Tools, die Ihre Daten dorthin bringen, wo sie gebraucht werden. Lassen Sie uns sprechen.