Skip to content

12. API LabKey

LabKey è dotata di uno strato di API per comunicare e scambiare dati con software esterni.

API LabKey

La struttura API permette di effettuare le operazioni simulando quasi la totalità delle funzioni del pannello di manage che diamo a corredo del KIT.

Tutte le chiamate devono essere attivate e provenire da un ip autorizzato.
Le API consentono di ottenere:

  • il token di autenticazione,
  • i log,
  • la lista delle LabKey,
  • la lista NFC

Inoltre è possibile: aggiungere, eliminare, modificare, assegnare, revocare i permessi ad un utente.

L'autenticazione viene fatta tramite un token JWT rilasciato dalla chiamata authorize e successivamente passato come header. Per poter ottenere il token dalla chiamata authorize è necessario disporre di email, password e la secret_key fornita.

Possibili errori per chiamata authorize: ip non autorizzato o secret_key errata (invalid_access) credenziali errate (invalid_credentials) errore generico (could not create token)

Possibili errori per le altre chiamate: token scaduto, non valido o non presente (invalid_token) Altri eventuali errori specifici vengono indicati nel campo messages del json di risposta

Attualmente non ci sono limiti al numero di chiamate che possono essere effettuate.

Per visualizzare la documentazione relativa a tutte le API disponibili clicca qui