SmartyFind

SmartyFind API-Referenz

Integrieren Sie Katalog, Suche, Events und Konfiguration über sichere APIs mit begrenzten Schlüsseln.

SmartyFind / api · DEMO
1Quelle vorbereiten
2Verhalten konfigurieren
3Mit echten Fällen prüfen
Entwicklerreferenz

Öffentliche API: Suche und Vorschläge

Die Beispiele verwenden einen öffentlichen Shopschlüssel. Der Schlüssel bestimmt den Shop; storeId wird im Request-Body nicht benötigt. Verwenden Sie nur erlaubte Domains.

01

Suche mit Bestand und Preisgrenze

query ist erforderlich. language unterstützt ro, en, it, de und fr. inStock, priceMax, page und limit sind eigene Felder; filters enthält Listen von Attributwerten.

POST https://smartyfind.com/api/v1/search
Content-Type: application/json
x-api-key: PUBLIC_STORE_API_KEY

{
  "query": "schwarze Schuhe",
  "language": "de",
  "inStock": true,
  "priceMax": 150,
  "limit": 20,
  "page": 1
}
02

Vorschläge für eingegebenen Text

Senden Sie mindestens zwei Zeichen und fordern Sie höchstens zehn Vorschläge an. Unterscheiden Sie ältere Antworten von der zuletzt eingegebenen Suchanfrage.

POST https://smartyfind.com/api/v1/suggestions
Content-Type: application/json
x-api-key: PUBLIC_STORE_API_KEY

{
  "query": "Sch",
  "language": "de",
  "limit": 5
}
03

Fehler und Zugangsdaten

401 kann einen ungültigen Schlüssel, 403 eine Zugriffsbeschränkung anzeigen. Verringern Sie bei 429 die Frequenz und warten Sie vor neuen Versuchen. Wiederholen Sie abgewiesene Requests nicht endlos. Administrative Vorgänge verwenden diesen öffentlichen Schlüssel nicht.

SmartyFind

Jedes Produkt leichter auffindbar machen

Katalog anbinden und die neue Produktentdeckung prüfen.

Kostenlos startenLeitfaden öffnen