Met API-sleutels kunnen scripts, integraties en AI-agents met je Caliu-account praten via de REST API op https://api.caliuapp.com.
Een sleutel maken
- In de web-app: open het gebruikersmenu onderaan de zijbalk, kies API-sleutels, dan Nieuwe API-sleutel. Geef die een naam die je vertelt waar hij voor is (bijvoorbeeld "Mijn script").
- In de iPhone- en iPad-app en de Mac-app: open Instellingen, dan Account, dan API-sleutels.
Elke sleutel begint met caliu_. Kopieer die meteen: voor de veiligheid slaat Caliu alleen een hash van je sleutel op, dus die wordt precies één keer getoond. De lijst toont later alleen een kort voorvoegsel, plus wanneer elke sleutel is gemaakt en voor het laatst is gebruikt.
Hem gebruiken
Stuur de sleutel als Bearer-token in de Authorization-header:
curl https://api.caliuapp.com/notes \
-H "Authorization: Bearer caliu_your_key_here"
Het volledige API-oppervlak is gedocumenteerd in de interactieve documentatie. Zie het artikel over API-documentatie.
Een sleutel intrekken
Trek elke sleutel in vanaf hetzelfde scherm waar je die hebt gemaakt. Intrekken is meteen van kracht: elke applicatie die die sleutel nog gebruikt, verliest bij het volgende verzoek de toegang. Behandel sleutels als wachtwoorden en zet ze nooit in code.