SmartyFind

Riferimento API SmartyFind

Integra catalogo, ricerca, eventi e configurazioni tramite API sicure con chiavi limitate per cliente e negozio.

SmartyFind / api · DEMO
1Prepara la fonte
2Configura il comportamento
3Valida casi reali
Riferimento sviluppatori

API pubblica: ricerca e suggerimenti

Gli esempi usano la chiave pubblica del negozio. Il negozio viene identificato dalla chiave: non serve storeId nel corpo. Usa solo domini autorizzati.

01

Ricerca con disponibilità e prezzo

query è obbligatorio. language accetta ro, en, it, de, fr. inStock, priceMax, page e limit sono campi separati; filters contiene liste di valori degli attributi.

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

{
  "query": "scarpe nere",
  "language": "it",
  "inStock": true,
  "priceMax": 150,
  "limit": 20,
  "page": 1
}
02

Suggerimenti per il testo digitato

Invia almeno due caratteri e richiedi al massimo dieci suggerimenti. Distingui la risposta a una ricerca precedente dall’ultimo testo digitato.

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

{
  "query": "sca",
  "language": "it",
  "limit": 5
}
03

Errori e credenziali

401 può indicare una chiave non valida; 403 una restrizione di accesso. Con 429 riduci la frequenza e riprova con attesa progressiva. Non ripetere in ciclo richieste rifiutate. Le operazioni amministrative non usano questa chiave pubblica.

SmartyFind

Rendi ogni prodotto più facile da trovare

Collega il catalogo e valuta la nuova esperienza di scoperta.

Inizia gratisApri la guida