SmartyFind

Référence API SmartyFind

Intégrez catalogue, recherche, événements et configuration via des API sécurisées et des clés limitées.

SmartyFind / api · DEMO
1Préparer la source
2Configurer le comportement
3Valider sur des cas réels
Référence développeurs

API publique : recherche et suggestions

Ces exemples utilisent la clé publique d’une boutique. La clé identifie la boutique : storeId n’est pas nécessaire dans le corps. Utilisez uniquement les domaines autorisés.

01

Recherche avec stock et prix maximal

query est obligatoire. language accepte ro, en, it, de et fr. inStock, priceMax, page et limit sont des champs séparés ; filters contient des listes de valeurs d’attributs.

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

{
  "query": "chaussures noires",
  "language": "fr",
  "inStock": true,
  "priceMax": 150,
  "limit": 20,
  "page": 1
}
02

Suggestions pour le texte saisi

Envoyez au moins deux caractères et demandez au maximum dix suggestions. Distinguez la réponse à une ancienne requête du dernier texte saisi.

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

{
  "query": "cha",
  "language": "fr",
  "limit": 5
}
03

Erreurs et identifiants

401 peut indiquer une clé incorrecte ; 403 une restriction d’accès. Avec 429, réduisez la fréquence et espacez les tentatives. Ne répétez pas indéfiniment une requête refusée. Les opérations administratives n’utilisent pas cette clé publique.

SmartyFind

Rendez chaque produit plus facile à trouver

Connectez le catalogue et évaluez la nouvelle découverte produit.

Commencer gratuitementOuvrir le guide