API y Webhooks

Con la API y los webhooks de Salonnare conectas tu salón con otro software: tu programa de contabilidad, tu propia web, un servicio de newsletter o un panel a medida. No necesitas ser desarrollador para entender qué hacen -- esta página lo explica con calma.

¿Qué es una API?

Una API (Application Programming Interface) es un acuerdo que permite que dos programas se comuniquen entre sí. Donde tú pulsas un botón en la app para cargar una cita, otro programa puede solicitar los mismos datos a través de la API -- de forma automática y sin intervención manual.

Ejemplos prácticos para un salón:

• Tu software de contabilidad recupera automáticamente tus ingresos cada noche.
• Tu propia web muestra tus servicios y precios, directamente desde Salonnare.
• Un socio de integración sincroniza tu lista de clientes.

El acceso a la API se realiza mediante una clave API: un código secreto que demuestra que la solicitud viene de ti. Trata esa clave como una contraseña.

Crear una clave API

1. Ve a Ajustes -> API y Webhooks.
2. Haz clic en Nueva clave API.
3. Dale a la clave un nombre reconocible (por ejemplo "Contabilidad") y elige los permisos: solo lectura o lectura y escritura.
4. Copia la clave de inmediato y guárdala en un lugar seguro. Por motivos de seguridad, Salonnare muestra la clave completa una sola vez.

¿Sospechas que una clave se ha filtrado? Elimínala enseguida -- toda integración que use esa clave se detiene de inmediato.

¿Qué es un webhook?

Un webhook es lo contrario de la API. En lugar de que tú recuperes datos, Salonnare envía automáticamente un mensaje a una dirección (URL) tuya en cuanto ocurre algo. El otro software ya no tiene que preguntar constantemente "¿hay algo nuevo?" -- recibe un aviso por sí solo.

Salonnare puede enviar, entre otros, estos eventos:

• booking.created -- se ha creado una nueva cita
• booking.updated -- se ha modificado una cita
• booking.cancelled -- se ha cancelado una cita
• payment.received -- se ha recibido un pago
• client.created -- se ha creado un nuevo cliente
• client.updated -- se han modificado los datos de un cliente

Configurar un webhook

1. Ve a Ajustes -> API y Webhooks y abre la pestaña Webhooks.
2. Haz clic en Nuevo webhook.
3. Introduce la URL a la que Salonnare enviará las notificaciones (te la facilita tu socio de integración o desarrollador).
4. Elige los eventos a los que quieres reaccionar.
5. Guarda. Después puedes revisar los registros de envío para comprobar que las notificaciones llegan correctamente.

Trabajar con seguridad

• Nunca compartas las claves API públicamente (ni en correos, ni en capturas de pantalla, ni en código publicado en línea).
• Da a cada integración solo los permisos que realmente necesita -- elige solo lectura cuando sea posible.
• Elimina las claves y webhooks que ya no uses.

Como Salonnare procesa tus datos en la UE y tú decides qué integraciones tienen acceso, mantienes el control total de tus datos. ¿Necesitas ayuda con una integración? No dudes en contactarnos a través de la página de soporte.