API REST v1 do Calendinho
Novas integrações devem usar a base https://api.calendinho.com/api/v1. O contrato OpenAPI em api.calendinho.com/openapi.json é a fonte de verdade para parâmetros, corpos, autenticação e respostas. Uma interface Swagger está disponível em api.calendinho.com/docs e o ReDoc em api.calendinho.com/redoc.
Operações do titular usam um bearer token emitido para a sessão autenticada. Algumas consultas de perfil, disponibilidade e criação de reservas são públicas por projeto; não presuma que outros endpoints dispensam autenticação. A plataforma ainda não oferece chaves de API externas por autosserviço.
curl -sS \
-H 'Accept: application/json' \
https://api.calendinho.com/api/v1/public/profiles/SEU_SLUG
Limites de requisição
Respostas da API expõem os campos estruturados RateLimit e RateLimit-Policy, além dos campos de compatibilidade RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset. Uma resposta 429 Too Many Requests também inclui Retry-After; aguarde esse número de segundos e evite novas tentativas em paralelo. O limite geral é de 600 requisições por minuto por origem, e operações sensíveis podem ter limites menores documentados.
Versões e depreciação
A versão estável está no caminho /api/v1. O caminho legado /api continua funcional para preservar o frontend e integrações existentes, mas retorna Deprecation e um Link para esta política. Não há data de desligamento agendada. Se houver, publicaremos o header Sunset, um guia de migração e um aviso mínimo de 180 dias. Mudanças incompatíveis serão lançadas em uma nova versão de caminho; campos opcionais e novos endpoints podem ser adicionados à v1.
Model Context Protocol
Agentes compatíveis com MCP podem descobrir ferramentas e esquemas diretamente nos servidores:
- Titular autenticado:
https://api.calendinho.com/mcp/ - Convidado:
https://api.calendinho.com/mcp/guest/ - Agente de e-mail:
https://api.calendinho.com/mcp/email/
Use apenas a superfície correspondente à autoridade do usuário. O servidor do titular requer contexto de autenticação. Leia também as instruções para agentes e o índice llms.txt.
CLI
Ainda não existe um CLI oficial publicado em npm, PyPI ou Homebrew. Para automação, use a API REST versionada ou MCP. Não instale pacotes de terceiros como se fossem mantidos pelo Calendinho.