Le chiavi API permettono a script, integrazioni e agenti AI di comunicare con il tuo account Caliu tramite l'API REST su https://api.caliuapp.com.
Creare una chiave
- Nell'app web: apri il menu utente in fondo alla barra laterale, scegli Chiavi API, poi Nuova chiave API. Dalle un nome che ti dica a cosa serve (ad esempio "Il mio script").
- Nell'app per iPhone e iPad e nell'app per Mac: apri le Impostazioni, poi Account, poi Chiavi API.
Ogni chiave inizia con caliu_. Copiala subito: per sicurezza, Caliu conserva solo un hash della tua chiave, quindi viene mostrata esattamente una volta. L'elenco in seguito mostra solo un breve prefisso, più quando ogni chiave è stata creata e usata l'ultima volta.
Usarla
Invia la chiave come token Bearer nell'intestazione Authorization:
curl https://api.caliuapp.com/notes \
-H "Authorization: Bearer caliu_your_key_here"
L'intera superficie dell'API è documentata nella documentazione interattiva. Vedi l'articolo sulla documentazione dell'API.
Revocare una chiave
Revoca qualsiasi chiave dalla stessa schermata dove l'hai creata. La revoca è immediata: qualsiasi applicazione che usa ancora quella chiave perde l'accesso alla richiesta successiva. Tratta le chiavi come password e non inserirle mai nel codice.