Les clés API permettent aux scripts, aux intégrations et aux agents IA de dialoguer avec votre compte Caliu à travers l'API REST sur https://api.caliuapp.com.
Créer une clé
- Dans l'app web : ouvrez le menu utilisateur en bas de la barre latérale, choisissez Clés API, puis Nouvelle clé API. Donnez-lui un nom qui vous indique à quoi elle sert (par exemple « Mon script »).
- Dans l'app iPhone et iPad et l'app Mac : ouvrez les Réglages, puis Compte, puis Clés API.
Chaque clé commence par caliu_. Copiez-la tout de suite : pour la sécurité, Caliu ne stocke qu'un hachage de votre clé, elle n'est donc affichée qu'une seule fois. La liste ne montre ensuite qu'un court préfixe, avec la date de création et de dernière utilisation de chaque clé.
L'utiliser
Envoyez la clé comme jeton Bearer dans l'en-tête Authorization :
curl https://api.caliuapp.com/notes \
-H "Authorization: Bearer caliu_your_key_here"
Toute la surface de l'API est documentée dans la documentation interactive. Voir l'article sur la documentation de l'API.
Révoquer une clé
Révoquez n'importe quelle clé depuis l'écran même où vous l'avez créée. La révocation est immédiate : toute application qui utilise encore cette clé perd l'accès à sa prochaine requête. Traitez les clés comme des mots de passe et ne les mettez jamais dans du code versionné.