API REST v1 de Calendinho
Las integraciones nuevas deben usar https://api.calendinho.com/api/v1. El contrato OpenAPI en api.calendinho.com/openapi.json es la fuente de verdad para parámetros, cuerpos, autenticación y respuestas. Swagger UI está disponible en api.calendinho.com/docs y ReDoc en api.calendinho.com/redoc.
Las operaciones del titular usan un token bearer emitido para la sesión autenticada. Algunas consultas de perfil, disponibilidad y creación de reservas son públicas por diseño; no supongas que otros endpoints omiten autenticación. Las claves de API externas de autoservicio todavía no están disponibles de forma general.
curl -sS \
-H 'Accept: application/json' \
https://api.calendinho.com/api/v1/public/profiles/TU_SLUG
Límites de solicitud
Las respuestas exponen los campos estructurados RateLimit y RateLimit-Policy, además de los campos de compatibilidad RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset. Un 429 Too Many Requests también incluye Retry-After; espera ese número de segundos y evita reintentos paralelos. La política general es de 600 solicitudes por minuto por origen, con límites menores documentados para operaciones sensibles.
Versiones y deprecación
La versión estable está en /api/v1. El camino heredado /api sigue funcionando para preservar el frontend y las integraciones existentes, pero devuelve Deprecation y un Link a esta política. No hay fecha de cierre programada. Si se define, Calendinho publicará Sunset, una guía de migración y un aviso mínimo de 180 días. Los cambios incompatibles usarán una nueva versión; se pueden agregar campos opcionales y endpoints a v1.
Model Context Protocol
Los agentes compatibles con MCP pueden descubrir herramientas y esquemas en:
- Titular autenticado:
https://api.calendinho.com/mcp/ - Invitado:
https://api.calendinho.com/mcp/guest/ - Agente de correo:
https://api.calendinho.com/mcp/email/
Usa solamente la superficie que corresponde a la autoridad del usuario. El servidor del titular requiere autenticación. Lee también las instrucciones para agentes y el índice llms.txt.
CLI
Calendinho todavía no publica un CLI oficial en npm, PyPI o Homebrew. Para automatización, usa la API REST versionada o MCP. No trates paquetes de terceros como herramientas mantenidas por Calendinho.