Token API¶
Un token di accesso personale permette a uno script, a un job di CI o a qualsiasi integrazione di chiamare la REST API di Empi a tuo nome. Vede esattamente ciò che vedi tu e può modificare esattamente ciò che puoi modificare tu.
Creare un token¶
- Apri Settings > API.
- Fai clic su Create token.
- Assegnagli un Name (per esempio "CI pipeline") così da riconoscerlo in seguito.
- Scegli i suoi Permissions: Read-only (solo richieste GET) oppure Read & write (lettura e modifica dei dati).
- Scegli una Expiration: 7 giorni, 30 giorni, 90 giorni, 1 anno oppure nessuna scadenza.
- Fai clic su Create, poi copia il segreto.
Warning
Il segreto viene mostrato una sola volta, alla creazione. Concede accesso all'intero workspace, quindi conservalo come una password (un gestore di segreti, l'archivio dei segreti della tua CI) e non incollarlo mai in un documento condiviso o in un repository pubblico. Se un token trapela, revocalo immediatamente: la revoca ha effetto all'istante.
Ogni riga di token mostra quando scade e quando è stato usato l'ultima volta, così puoi individuare quello che avevi dimenticato.
Usare un token¶
Invialo come bearer token nelle tue richieste API. L'elenco completo degli endpoint, dei loro parametri e delle loro risposte si trova nel riferimento della API.
Revocare un token¶
Fai clic su Revoke nella riga del token e conferma. Il token smette di funzionare immediatamente e non può essere ripristinato. Creane uno nuovo se hai ancora bisogno dell'accesso.
Le chiamate effettuate con un token sono attribuite all'API nel tuo registro attività.
Tip
Se il tuo obiettivo è far lavorare un assistente AI con le tue attività, non ti serve affatto un token. Usa invece il server MCP: accede tramite il tuo browser e puoi disconnetterlo in qualsiasi momento.