Collector API — Guida all’integrazione

Panoramica

Questa guida si rivolge a sviluppatori che desiderano integrare AccelaSearch su piattaforme non nativamente supportate. Tutti i dati vengono inviati tramite chiamate REST autenticate con API key.

Per integrare AccelaSearch, è necessario seguire questi passi:

  1. Registrarsi presso https://accelasearch.com/ e ottenere una API key.
  2. Creare un negozio tramite l’endpoint dedicato e annotare il suo UUID.
  3. Inviare i prodotti tramite le API di ingestione.
  4. Configurare il motore di ricerca dalla console AccelaSearch mentre i dati vengono caricati.
  5. Avviare l’indicizzazione tramite l’endpoint dedicato; al termine il motore di ricerca sarà operativo.

Dopo la prima sincronizzazione, puoi aggiornare il catalogo in qualunque momento inviando nuove chiamate alle API di ingestione e richiedendo una nuova indicizzazione.

Autenticazione

Ogni chiamata API richiede la presenza dell’header X-Accelasearch-Apikey:

curl -X GET <https://svc11.accelasearch.net/API/shops> \\
  -H "X-Accelasearch-Apikey: YOUR-SECRET-API-KEY"

La API key è collegata al tuo account e non può essere condivisa. Puoi recuperarla in qualunque momento dalla console AccelaSearch.

Identificativo del negozio (UUID)

Ogni negozio è identificato da un UUID — una stringa alfanumerica univoca (es. a3f8c2d1-4e5b-6f7a-8b9c-0d1e2f3a4b5c). L’UUID viene generato automaticamente alla creazione del negozio e deve essere usato come parametro {id} in tutte le chiamate che operano su uno shop specifico.