Alles wat de Caliu-apps doen, gaat via de openbare REST API op https://api.caliuapp.com: notities, tags, herinneringen, bijlagen, zoeken, synchronisatie, delen en exporteren. Alles wat de apps kunnen, kan jouw code ook.
Interactieve documentatie
Blader door elk endpoint, schema en voorbeeldverzoek in de interactieve referentie:
- api.caliuapp.com/docs, rechtstreeks vanuit de API geserveerd
- caliuapp.com/docs, dezelfde referentie ingebed op de website van Caliu
Met beide kun je de vorm van verzoeken en antwoorden verkennen en aanroepen vanuit de browser uitproberen. Er is ook een snelkoppeling API-documentatie bekijken op het scherm API-sleutels in de apps.
OpenAPI-specificatie
De API wordt beschreven door een OpenAPI 3.1-document, gegenereerd vanuit dezelfde code die de endpoints serveert, zodat het nooit afwijkt van de werkelijkheid:
https://api.caliuapp.com/openapi.json
Voer het aan codegeneratoren, API-clients zoals Postman of je eigen gereedschap.
Authenticatie
De meeste endpoints verwachten een API-sleutel verzonden als Bearer-token:
Authorization: Bearer caliu_your_key_here
Zie het artikel over API-sleutels om er een te maken. Als je voor AI-agents bouwt, behandelt het artikel over de MCP-server een integratie op hoger niveau.