Tudo o que as aplicações Caliu fazem passa pela API REST pública em https://api.caliuapp.com: notas, etiquetas, lembretes, anexos, pesquisa, sincronização, partilha e exportação. Tudo o que as aplicações conseguem fazer, o teu código também consegue.
Documentação interativa
Explora todos os endpoints, esquemas e exemplos de pedido na referência interativa:
- api.caliuapp.com/docs, servida diretamente a partir da API
- caliuapp.com/docs, a mesma referência incorporada no site do Caliu
Ambas te deixam explorar as formas de pedido e resposta e experimentar chamadas a partir do navegador. Há também um atalho Ver documentação da API no ecrã de Chaves de API nas aplicações.
Especificação OpenAPI
A API é descrita por um documento OpenAPI 3.1, gerado a partir do mesmo código que serve os endpoints, por isso nunca se afasta da realidade:
https://api.caliuapp.com/openapi.json
Alimenta-o a geradores de código, a clientes de API como o Postman, ou às tuas próprias ferramentas.
Autenticação
A maioria dos endpoints espera uma chave de API enviada como token Bearer:
Authorization: Bearer caliu_your_key_here
Consulta o artigo sobre chaves de API para criar uma. Se estás a construir para agentes de IA, o artigo sobre o servidor MCP cobre uma integração de nível mais alto.