Developeri

API pentru căutare și catalog

Folosește chei limitate pe client și magazin pentru integrarea controlată.

SmartyFind / api · DEMO
1Pregătește sursa
2Configurează comportamentul
3Validează pe cazuri reale
Referință pentru dezvoltatori

API public: căutare și sugestii

Aceste exemple folosesc cheia publică a unui magazin. Magazinul este identificat din cheie, nu dintr-un storeId trimis în corp. Folosește doar domeniile autorizate.

01

Căutare cu stoc și limită de preț

query este obligatoriu. language este una dintre ro, en, it, de, fr. inStock, priceMax, page și limit sunt câmpuri separate; filters conține liste de valori pentru atribute.

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

{
  "query": "pantofi negri",
  "language": "ro",
  "inStock": true,
  "priceMax": 150,
  "limit": 20,
  "page": 1
}
02

Sugestii pentru textul introdus

Trimite minimum două caractere și cel mult zece sugestii. Aplicația trebuie să trateze răspunsul vechi al unei interogări separat de ultima expresie tastată.

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

{
  "query": "pan",
  "language": "ro",
  "limit": 5
}
03

Erori și credențiale

401 poate indica o cheie invalidă; 403 poate indica o restricție de acces. La 429 redu ritmul și reîncearcă cu întârziere. Nu repeta în buclă o cerere respinsă. Operațiunile administrative nu folosesc această cheie publică.

SmartyFind

Fă fiecare produs mai ușor de găsit

Conectează catalogul și verifică modul în care căutarea inteligentă schimbă descoperirea produselor.

Începe gratuitVezi ghidul