API

Kananas offre ai programmatori la sua API RESTful: documentazione dettagliata dell’API di Kananas

Questa API ti consente di connettere un altro software al tuo account Kananas per recuperare informazioni o eseguire determinate funzioni: elenco dei contatti, creazione di spese, ecc…

L’accesso all’API è soggetto all’ottenimento di una chiave segreta che puoi impostare tramite il menu “Impostazioni/API”.

chiave segreta dell'API

Questa chiave deve essere utilizzata per ogni chiamata all’API, passandola nell’intestazione della richiesta.

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

Webhooks:

Oltre all’API, offriamo anche i webhook. Si tratta di un meccanismo che consente di inviare le modifiche apportate in Kananas ad altre applicazioni.

I webhook possono essere configurati nella pagina “Impostazioni/API”. Questa funzionalità è accessibile solo all’utente amministratore.

I webhook offrono diversi vantaggi:

  1. Notifiche in tempo reale: i webhook consentono a un’applicazione di ricevere notifiche in tempo reale quando si verifica un evento su un altro sistema o servizio. Ciò consente all’applicazione di reagire immediatamente all’evento e di intraprendere azioni di conseguenza, come la registrazione online di un nuovo contatto.
  2. Riduzione del traffico: i webhook aiutano a evitare di inquinare i server con query regolari per verificare se sono disponibili nuovi dati. Invece, i dati vengono inviati all’applicazione quando sono disponibili, riducendo il traffico di rete.
  3. Flessibilità: i webhook offrono grande flessibilità per gli sviluppatori. Possono scegliere gli eventi per i quali desiderano ricevere notifiche.
  4. Automazione delle attività: i webhook consentono di pianificare attività automatizzate che vengono eseguite in risposta a eventi specifici. Ciò consente l’automazione delle attività noiose e il risparmio di tempo.
  5. Facile integrazione: i webhook possono essere facilmente integrati in un’applicazione esistente o in un sistema di terze parti. Sono ampiamente supportati da molte applicazioni e servizi, rendendoli molto popolari per l’integrazione di sistemi.

 

Automazione

L’API può essere utilizzata per estendere le funzionalità di Kananas attraverso strumenti di automazione come Zapier o Make. Ad esempio, è possibile recuperare i dati inseriti in un modulo di contatto su un sito web, inviarli a Kananas per creare un contatto e quindi ricevere una notifica.

Esempio di automazione creata con make.com

kananas webhook