Kalendia

Contrato API para chatbots externos

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

ÁreaOperaciones
NegocioDatos públicos, políticas y enlaces oficiales
AgendaServicios, recursos reservables, equipo público, disponibilidad, creación y gestión verificada de citas
TiendaCategorías, productos, variantes, inventario y creación o consulta verificada de pedidos
PagosMétodos públicos, estado verificado y creación de enlaces de pago
AtenciónContactos 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.

Scroll al inicio