API

Kananas posa a disposició dels desenvolupadors la seva API Restfull:  documentació detallada de l’API Kananas

Aquesta API us permetrà connectar un altre programari al vostre compte Kananas per obtenir informació o executar certes funcions: llista de contactes, creació d’una despesa, etc.

La connexió a l’API està subjecta a l’obtenció d’una clau secreta que podeu definir a través del menú « parametrització/API ».

api clau secreta

Aquesta clau s’ha d’utilitzar per a cada crida d’API, passant-la al capçal de la sol·licitud.

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

Webhooks:

A més de l’API, també us proposem webhooks. Es tracta d’un mecanisme que permet enviar els canvis fets a Kananas a altres aplicacions.

Els webhooks es poden parametritzar a la pàgina parametrització/API. Aquesta funcionalitat només és accessible per a l’usuari administrador.

Els webhooks ofereixen diversos avantatges:

  1. Notificacions en temps real: Els webhooks permeten a una aplicació rebre notificacions en temps real quan es produeix un esdeveniment en un altre sistema o servei. Això permet a l’aplicació reaccionar immediatament a l’esdeveniment i prendre les mesures corresponents: la inscripció en línia d’un nou contacte, per exemple.
  2. Reducció del trànsit: Els webhooks permeten evitar saturar els servidors amb sol·licituds regulars per saber si hi ha noves dades disponibles. En lloc d’això, les dades s’envien a l’aplicació quan estan disponibles, reduint així el trànsit a la xarxa.
  3. Flexibilitat: Els webhooks ofereixen una gran flexibilitat als desenvolupadors. Poden triar els esdeveniments pels quals volen rebre notificacions.
  4. Automatització de tasques: Els webhooks permeten programar tasques automatitzades que s’executen en resposta a esdeveniments específics. Això permet automatitzar tasques tedioses i estalviar temps.
  5. Integració fàcil: Els webhooks es poden integrar fàcilment a una aplicació existent o a un sistema tercer. Són àmpliament compatibles amb moltes aplicacions i serveis, cosa que els fa molt populars per a la integració de sistemes.

Automatització

L’API es pot utilitzar per ampliar les funcionalitats de Kananas mitjançant eines d’automatització com Zapier o Make. Per exemple, podeu recuperar les dades introduïdes en un formulari de contacte d’un lloc web, enviar-les a Kananas perquè creï un contacte i enviar-vos després una notificació.

Zapier

Zapier és una eina en línia que permet automatitzar tasques entre diferents aplicacions web. Amb la capacitat de connectar-se a més de 2.000 aplicacions, Zapier facilita la creació de processos automatitzats adaptats a les necessitats específiques de cada usuari.

A Zapier trobareu una App Kananas que us permetrà, sense coneixements de desenvolupament informàtic, utilitzar els desencadenants:

  • Adhesió en línia des del formulari Kananas
  • Pagament en línia fet a l’espai personal
  • Modificació d’un contacte (creació, modificació, eliminació)
  • Modificació d’una activitat (creació, modificació, eliminació)

I les accions:

  • Consultar el dossier d’un contacte
  • Crear un contacte
  • Modificar un contacte
  • Afegir un achat

Per utilitzar-la, heu de recuperar la vostra clau secreta a parametrització/API (només visible quan esteu connectats amb l’identificador d’administrador).

Exemple d’implementació:

Un formulari creat a Tally es transmet després a Kananas i s’envia un correu de benvinguda.