Entwicklung einer Such-API und eines einbettbaren Widgets fuer Farnall
Farnall wollte, dass ihre Produktsuche auf den Websites anderer funktioniert. Wir haben eine API gebaut, die ein eigenstaendiges Iframe-Widget antreibt und Partnern eine voll funktionsfaehige Sucherfahrung bietet, ohne die zugrunde liegenden Daten oder Systeme offenzulegen.
Suche, die ueberall lebt
Farnall brauchte eine Moeglichkeit, 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 Geschaefts. Partner und Wiederverkaeufer mussten regelmaessig 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 einfuegen und nativ anfuehlen konnte, waehrend Farnall die volle Kontrolle ueber Daten und Darstellung behielt.
Die Loesung musste fuer Partner einfach zu uebernehmen sein. Keine SDKs, keine API-Keys auf deren Seite, kein Frontend-Code zum Schreiben. Nur ein einziges Iframe-Embed, das Besuchern Zugang zu Farnalls Suchfunktionalitaet gibt.
Auf Farnalls Seite mussten sie kontrollieren koennen, welche Domains das Widget einbetten duerfen, welche Produktkategorien pro Partner sichtbar sind und wie Ergebnisse dargestellt werden. Die API musste der zentrale Kontrollpunkt fuer all das sein.
Suche muss in der Partner-Website leben
Farnall brauchte ihre Produktsuche nahtlos innerhalb von Drittanbieter-Websites ueber ein Iframe, ohne dass diese Partner Zugang zur zugrunde liegenden Dateninfrastruktur benoetigen.
Kontrollierter Zugang zu Produktdaten
Die API musste Suchergebnisse nur an autorisierte Iframes liefern. Partner betten das Such-Widget ein, aber Farnall behaelt die volle Kontrolle darueber, welche Daten exponiert werden und wie sie dargestellt werden.
Schnelle, relevante Ergebnisse
Endnutzer, die innerhalb des eingebetteten Widgets suchen, erwarteten sofortige, praezise Ergebnisse. Die API musste Filterung, Keyword-Matching und Kategorienavigation ohne spuerbare Verzoegerung bewaeltigen.
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 eigenstaendige Suchoberflaeche, die per einzelnem Iframe-Tag in jede Website eingefuegt werden kann. Verwaltet eigenes Styling, Paginierung und Ergebnisanzeige, ohne in die Host-Seite ueberzugreifen.
Herkunftsbasierte Zugriffskontrolle
Die API validiert Anfragen gegen eine Whitelist genehmigter Domains. Nicht autorisierte Quellen erhalten keine Daten, wodurch Farnalls Produktkatalog geschuetzt bleibt.
Konfigurierbares Suchverhalten
Partner koennen Parameter uebergeben, 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
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 fuer Kategoriefilterung und Darstellungspraeferenzen.
Nutzer sucht im Widget
Besucher auf der Partner-Website geben eine Suchanfrage ein oder durchstoebern Kategorien. Das Frontend des Iframes sendet Anfragen an die Farnall-Such-API und uebergibt die Domain des Partners zur Validierung.
API liefert gefilterte Ergebnisse
Die API prueft die anfragende Herkunft, fuehrt die Abfrage gegen Farnalls Produktindex aus und liefert strukturierte Ergebnisse. Das Iframe rendert sie sofort ohne Seitenneuladung.
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 beruehren.
Eine Zeile HTML, volle Sucherfahrung
Partner fuegen ein einziges Iframe-Tag in ihre Seite ein. Alles andere wird vom Widget und der dahinterliegenden API erledigt.
Das Iframe-Widget ist eine eigenstaendige SvelteKit-Anwendung, die ausschliesslich mit der Farnall-Such-API kommuniziert. Es rendert eigene Suchleiste, Filter, Ergebnisraster und Produktdetailansichten vollstaendig innerhalb der Iframe-Grenze.
Da das Widget eigenstaendig ist, greift es nie in die Styles oder Skripte der Host-Seite ein. Partner muessen sich keine Sorgen ueber CSS-Konflikte, JavaScript-Kollisionen oder Layout-Probleme machen. Das Widget passt sich an jede Containerbreite an.
Aus Nutzersicht fuehlt 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 Seitengroesse
- 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.