Procedura: Creare app personalizzate con l'API REST
Accesso come
amministratore
in Peakon.È possibile utilizzare un'API REST esterna fornita da Peakon per creare applicazioni e integrazioni personalizzate per il provisioning dei dipendenti e accedere a risorse altrimenti esposte solo con il dashboard di Peakon.
Rivedere le risorse nella documentazione dell'API. Visita: https://developer.peakon.com/
- Nel tenant Peakon, accedere ad .
- Assegnare un nome all'applicazione e creare le autorizzazioni.Peakon consiglia di concedere autorizzazioni minime per le applicazioni.
- Copiare iltoken di accessogenerato.Il token è l'unica credenziale utilizzata dall'applicazione per accedere alle risorse remote in Peakon e viene visualizzato una sola volta. Peakon consiglia di tenerlo al sicuro e di non condividerlo con altre applicazioni.
- Chiamare l'endpoint POST /v1/auth/application.Specificare il token di accesso generato nel corpo della richiesta dell'endpoint POST /v1/auth/application. In risposta a una richiesta di autenticazione riuscita, questo endpoint restituisce un token Web JSON. Per i dettagli, consultare l'endpoint dell'applicazione di autenticazione in Peakon API Reference.
- Incorporare il token JWT nell'intestazione Authorization delle richieste API successive.La separazione dei token di autenticazione e di autorizzazione consente una distribuzione in cui solo uno sviluppatore di applicazioni o un amministratore aziendale ha accesso al token di autenticazione. Assegnare e condividere i token di autorizzazione con gli utenti dell'applicazione.
- Inviare le richieste API Peakon appropriate dalla nuova applicazione.È possibile inviare una richiesta con parametri aggiuntivi. Esempio: filtrare i dati o specificare un intervallo di tempo. Per un elenco degli endpoint API e dei relativi parametri, consultare Peakon API Reference.