Esta referencia describe el contrato público de la API v1 para chatbots externos de Kalendia. Está dirigida a equipos que integran n8n, Make o aplicaciones propias.
Autenticación
Usa HTTPS y envía Authorization: Bearer TU_CREDENCIAL. La credencial pertenece a una conexión y queda limitada por sus permisos, estado, vencimiento y límite de peticiones.
Rutas principales
| Área | Operaciones |
|---|---|
| Negocio | Datos públicos, políticas y enlaces oficiales |
| Agenda | Servicios, recursos reservables, equipo público, disponibilidad, creación y gestión verificada de citas |
| Tienda | Categorías, productos, variantes, inventario y creación o consulta verificada de pedidos |
| Pagos | Métodos públicos, estado verificado y creación de enlaces de pago |
| Atención | Contactos autorizados y solicitudes de soporte |
Respuestas y errores
Las respuestas usan JSON. Los errores incluyen un código estable y un mensaje comprensible. Los estados habituales son 400 para datos inválidos, 401 para credencial ausente o inválida, 403 para permiso insuficiente, 404 para un recurso no encontrado y 429 cuando se supera el límite.
Seguridad
- Las consultas privadas exigen referencias y verificación independiente del cliente.
- Las credenciales financieras y secretos de pasarela nunca se exponen.
- Los webhooks se firman y solo aceptan endpoints HTTPS públicos.
- Kalendia registra trazabilidad técnica sin conservar tokens ni cuerpos privados.
La especificación OpenAPI completa se conserva versionada en el módulo de integración. Solicita el archivo YAML si necesitas importarlo directamente en una herramienta de desarrollo.
Especificación OpenAPI
Los desarrolladores pueden consultar o importar el contrato técnico completo en formato YAML.