L’API di Loyaltify permette al tuo sviluppatore di collegare Loyaltify ai tuoi sistemi, come una cassa, uno strumento di prenotazione o il tuo sito web. Ad esempio, una cassa può aggiungere punti automaticamente dopo ogni vendita, così il tuo team non deve scansionare la carta.
Questa guida è per te e per il tuo sviluppatore: dove trovare la tua chiave API, dove si trova la documentazione e cosa è utile sapere prima di iniziare a sviluppare.
💡 Buono a sapersi: questa funzione fa parte del piano Advanced. Smette di funzionare se passi a un piano inferiore.
Trova la tua chiave API
In Loyaltify, clicca sul tuo nome in alto a destra.
Vai su Profilo e copia la tua chiave API.
Non vedi una chiave API nel tuo account Advanced? Contatta l’assistenza tramite la chat dal vivo e la attiveremo per te.
⚠️ Tratta la tua chiave API come una password. Condividila solo con il tuo sviluppatore e non inserirla mai nel codice di un sito web o in un link.
Leggi la documentazione
La documentazione completa dell’API si trova su api.loyaltify.io/api-docs. Alcune cose che il tuo sviluppatore dovrebbe sapere:
Invia la chiave API nell’header
X-API-Keycon ogni richiesta.Usa l’indirizzo di produzione,
api.loyaltify.io.Se apri un endpoint nel browser, vedrai “Unauthorized”. È normale, perché il browser non invia la tua chiave.
Cosa puoi fare con l’API
Iscrivere clienti tramite uno dei tuoi moduli di iscrizione, ad esempio dal tuo sito web o dalla tua app. La risposta include i link alla carta del cliente per Apple Wallet e Google Wallet.
Cercare clienti e le loro transazioni, aggiornarne i dati o eliminarli.
Aggiungere timbri, punti o credito, o riscattare premi con una richiesta di scansione, proprio come fa il tuo team nell’app Loyaltify Store. Cosa inviare dipende dal tipo di carta.
Buono a sapersi
Il codice QR su ogni carta ha sempre lo stesso formato:
lytf-, l’ID del tuo store, poi l’ID del cliente. Una cassa può leggerlo per trovare il cliente giusto.Ogni cliente ha due ID: un ID cliente breve (quello sulla sua carta e nei webhook) e un numero interno usato da alcune richieste API. La documentazione spiega come risalire dall’uno all’altro.
Ti serve l’ID del tuo store? Contatta l’assistenza tramite la chat dal vivo.
Più punti vendita o casse possono usare la stessa chiave API.
Vuoi sapere quando succede qualcosa? Usa i Webhooks per ricevere un messaggio ogni volta che un cliente si iscrive o guadagna punti.
💡 Vuoi che lo sviluppiamo noi? Creiamo anche integrazioni personalizzate, con un preventivo a parte. Contattaci tramite la chat dal vivo indicando il sistema che usi e cosa vorresti che succedesse.
Hai bisogno di aiuto?
Siamo qui per aiutarti!
Se hai domande sull’API, scrivici tramite la chat dal vivo all’interno di Loyaltify, oppure usa il pulsante della chat in basso a destra in questa pagina. Il nostro team sarà felice di aiutarti.