Le API consentono l’integrazione tra il sistema e applicazioni esterne, permettendo lo scambio strutturato di dati e l’automazione di specifici processi.
Attraverso le API è possibile interrogare il sistema, inviare informazioni e sincronizzare funzionalità in modo sicuro e controllato.
Il flusso di lavoro è il seguente:
Ottenere un token temporaneo (della durata di 4h) utilizzando il metodo POST /public/ApiToken.
Memorizzare il token ottenuto e rinnovarlo alla scadenza.
Nota: anche la chiamata ad ApiToken concorre al raggiungimento del tetto massimo di chiamate orarie (sono permesse fino a 360 chiamate all’ora).Effettuare le chiamate per la gestione delle Persone, passando il token ottenuto al punto precedente come Bearer token nell’header HTTP.
Per poter utilizzare l’endpoint ApiToken è necessaria una ApiKey, che va generata dal portale utilizzando le credenziali di un utente Admin di Geobadge:
Accedere al portale e aprire la sezione Account → Configurazione generale:
Nella sezione “Collegamenti ad app e servizi di terze parti”, aggiungere un nuovo collegamento a un’app/servizio.
Come nome, suggeriamo di utilizzare quello del software che andrai a integrare:
Attenzione, il secret che verrà generato sarà visibile solo in quel momento e successivamente sarà oscurato:
