Всё, что делают приложения Caliu, проходит через публичный REST API по адресу https://api.caliuapp.com: заметки, теги, напоминания, вложения, поиск, синхронизация, обмен и экспорт. Всё, что умеют приложения, умеет и ваш код.
Интерактивная документация
Просматривайте каждый эндпоинт, схему и пример запроса в интерактивном справочнике:
- api.caliuapp.com/docs, отдаётся прямо из API
- caliuapp.com/docs, тот же справочник, встроенный на сайт Caliu
Оба позволяют изучить формы запросов и ответов и попробовать вызовы прямо из браузера. На экране «Ключи API» в приложениях также есть ярлык Открыть документацию API.
Спецификация OpenAPI
API описан документом OpenAPI 3.1, сгенерированным из того же кода, что обслуживает эндпоинты, поэтому он никогда не расходится с реальностью:
https://api.caliuapp.com/openapi.json
Скормите его генераторам кода, клиентам API вроде Postman или собственным инструментам.
Аутентификация
Большинство эндпоинтов ожидают ключ API, отправленный как Bearer-токен:
Authorization: Bearer caliu_your_key_here
О создании ключа смотрите статью о ключах API. Если вы строите для ИИ-агентов, статья о сервере MCP описывает более высокоуровневую интеграцию.