Le API consentono l’integrazione tra Geobadge 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, questa dovrà avere la struttura documentata nello swagger. E' possibile trovare il link direttamente dentro il proprio account Geobadge.
Accedere al portale e aprire la sezione Account > Configurazione generale > Collegamenti ad app e servizi di terze parti
Per poter utilizzare l’endpoint ApiToken è necessaria una ApiKey, che va generata dal portale
utilizzando le credenziali di un utente Admin di Geobadge. Per farlo:
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 si andrà ad integrare:
Attenzione, il secret che verrà generato sarà visibile solo in quel momento e successivamente sarà oscurato:
