API

Kananas pone a disposición de los desarrolladores su API Restful: documentación detallada de la API Kananas

Esta API le permitirá conectar otro software a su cuenta de Kananas para recuperar información o ejecutar ciertas funciones: lista de contactos, creación de un gasto, etc.

La conexión a la API está sujeta a la obtención de una clave secreta que puede definir a través del menú « configuración/API ».

Esta clave deberá ser utilizada para cada llamada a la API incluyéndola en el encabezado de la solicitud.

Ejemplo
curl –request GET \
–url ‘https://backoffice.kananas.com/action_manager.php?event=api&request=contacts’ \
–header ‘Accept: application/json’ \
–header ‘token: SECRET_KEY’

Webhooks:

Además de la API, también ofrecemos webhooks. Este es un mecanismo que permite enviar los cambios realizados en Kananas a otras aplicaciones.

Los webhooks se pueden configurar en la página configuración/API. Esta funcionalidad solo está accesible para el usuario administrador.

Los webhooks ofrecen varias ventajas:

  1. Notificaciones en tiempo real: Los webhooks permiten a una aplicación recibir notificaciones en tiempo real cuando ocurre un evento en otro sistema o servicio. Esto permite que la aplicación reaccione inmediatamente al evento y tome medidas en consecuencia, como la inscripción en línea de un nuevo contacto.
  2. Reducción del tráfico: Los webhooks evitan sobrecargar los servidores con solicitudes regulares para saber si hay nuevos datos disponibles. En su lugar, los datos se envían a la aplicación cuando están disponibles, reduciendo así el tráfico en la red.
  3. Flexibilidad: Los webhooks ofrecen una gran flexibilidad para los desarrolladores. Pueden elegir los eventos para los que desean recibir notificaciones.
  4. Automatización de tareas: Los webhooks permiten programar tareas automatizadas que se ejecutan en respuesta a eventos específicos. Esto permite automatizar tareas tediosas y ahorrar tiempo.
  5. Integración fácil: Los webhooks se pueden integrar fácilmente en una aplicación existente o en un sistema de terceros. Son ampliamente compatibles con muchas aplicaciones y servicios, lo que los hace muy populares para la integración de sistemas.

Automatización

La API puede utilizarse para ampliar las funcionalidades de Kananas mediante herramientas de automatización como Zapier o Make. Por ejemplo, puede recuperar los datos ingresados en un formulario de contacto de un sitio web, enviarlos a Kananas para que cree un contacto y luego enviarle una notificación.

Zapier

Zapier es una herramienta en línea que permite automatizar tareas entre diferentes aplicaciones web. Con la capacidad de conectarse a más de 2,000 aplicaciones, Zapier facilita la creación de procesos automatizados adaptados a las necesidades específicas de cada usuario.

En Zapier encontrará una App Kananas que le permitirá, sin conocimientos de desarrollo informático, utilizar los disparadores:

  • Membresía en línea desde el formulario Kananas
  • Pago en línea realizado en el espacio personal
  • Modificación de un contacto (creación, modificación, eliminación)
  • Modificación de una actividad (creación, modificación, eliminación)

Y las acciones:

  • Consultar el expediente de un contacto
  • Crear un contacto
  • Modificar un contacto
  • Añadir una compra

Para usarla, debe recuperar su clave secreta en configuración/API (solo visible estando conectado con el identificador de administrador).

Ejemplo de implementación:

Un formulario creado en Tally se envía a Kananas y se envía un correo de bienvenida.