Se stai già usando la vecchia versione della nostra API per inviarci i tuoi ordini e raccogliere le recensioni dei tuoi clienti, sappi che è disponibile una nuova versione, molto più efficiente.
Perché passare alla nuova versione?
- La vecchia API verrà presto disattivata: per continuare a raccogliere recensioni senza interruzioni, è fondamentale migrare alla nuova versione nei prossimi mesi.
- Migliori performance tecniche.
- Schermate di configurazione ripensate: l’impostazione della raccolta delle recensioni è ora più intuitiva e accessibile.
- Nuova pagina di monitoraggio: visualizza facilmente lo stato delle tue richieste di recensione.
- Gestione self-service delle email di richiesta: hai maggiore flessibilità per personalizzare gli invii e adattare la tua strategia di raccolta.
Come sapere quale versione dell’API stai usando?
Confronta gli screenshot qui sotto con il menu presente nel tuo account Recensioni Verificate:
| ✨ Nuova versione dell’API | 🖥️ Vecchia versione dell’API |
Una volta completata la migrazione, non avrai più accesso allo storico delle richieste di recensione associate alla vecchia API. Ricordati di esportare i dati, se ti servono.
La nuova API non consente di escludere prodotti specifici dalla raccolta delle recensioni.
Implementare la nuova API
Segui questi passaggi:
- Per prima cosa, contatta il nostro team: dobbiamo effettuare delle operazioni tecniche dal nostro lato.
- Una volta convalidata la richiesta, è essenziale disattivare la chiamata alla vecchia API. Eviterai così l’invio doppio degli ordini e non disturberai i clienti due volte.
-
Quando le nuove pagine di configurazione saranno disponibili nel tuo
account
Recensioni Verificate, vai nel menu a sinistra
Raccolta recensioni e poi su Configurazione.
- Poi seleziona API nella barra di configurazione.
- Clicca sul pulsante per creare il tuo account API.
- Una volta creato l’account, potrai visualizzare i parametri della tua API: URL, client ID e client secret.
- Poi, genera la tua chiave segreta cliccando su Visualizza chiave.
Se ne avrai bisogno, potrai rigenerare questa chiave in qualsiasi momento.
Struttura e invia la richiesta
L'API di Skeepers utilizza OpenId Connect Client Credential grant per autenticare le richieste. Questo metodo non autentica un utente specifico, ma verifica le credenziali e restituisce un access_token generico.
Questa autorizzazione (OpenId Connect Client Credential grant) è utilizzata per l'autenticazione da macchina a macchina.
https://auth.skeepers.io/realms/skeepers/protocol/openid-connect/token
-
Authorization: Imposta come
Basic <base64 encoded "clientId:clientSecret"> -
Content-Type: Imposta come
application/x-www-form-urlencoded
-
grant_type: Imposta come
client_credentials -
scope: Imposta come
openid
POST https://auth.skeepers.io/realms/skeepers/protocol/openid-connect/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Authorization: Basic <base64 encoded "clientId:clientSecret">
grant_type="client_credentials" & scope="openid"
Clicca su questo link (Swagger) per accedere alla guida per configurare e simulare le richieste di prova d'acquisto o di servizio. Qui, nella sezione Authentication, dovrai inserire l’identificativo del tuo sito web:
Trova i codici di integrazione
Per trovare la tua chiave segreta e l'ID del tuo sito web:
- Vai al menu laterale sinistro in Recensioni Verificate
Gestione account, poi
Il mio account.
- Le informazioni si trovano poi a destra della pagina nella sezione Codice di integrazione.
Monitorare la raccolta
Ora hai a disposizione una nuova pagina di monitoraggio delle tue richieste di recensione. Questo ti permette di verificare l’invio degli ordini/servizi e lo stato delle richieste.
Per accedere, vai nel menu a sinistra Raccolta recensioni e poi su Monitoraggio richieste.
Se desideri raccogliere solo recensioni Brand, elimina la variabile "prodotto" nella tua chiamata API.
Personalizza le tue email
La nuova versione dell’API ti consente di usare il configuratore email, per personalizzare le richieste e migliorare la raccolta!
Ti
invitiamo a
contattare il nostro team
per parlare dell’implementazione.