Integrazioni

Cosa sono le API e a cosa servono in azienda: spiegate con esempi concreti

Cosa sono le API, spiegate a chi gestisce un'azienda: esempi con e-commerce, corriere, banca e fatture, e cosa chiedere al fornitore prima di collegarli.

LT Luca Tocco · · 7 min di lettura

Ogni mattina, in amministrazione, qualcuno ripete gli stessi gesti. Scarica gli ordini arrivati dal negozio online e li ribatte nel gestionale. Apre il portale del corriere, crea le spedizioni e copia i numeri di tracciamento. Poi entra nell'home banking e spunta, uno per uno, i bonifici arrivati. Quando chiede al fornitore se si può fare in automatico, la risposta è sempre la stessa: «Sì, con le API».

Ma cosa sono le API, e perché fanno risparmiare? Proviamo a spiegarlo senza tecnicismi.

Le API (dall'inglese Application Programming Interface) sono le porte ufficiali da cui un programma può chiedere dati, o far fare operazioni, a un altro programma, seguendo regole scritte. Il gestionale, per esempio, può chiedere al negozio online «dammi gli ordini pagati da ieri» e ricevere la risposta in un formato preciso, senza che nessuno copi niente a mano. In azienda servono a far passare ordini, spedizioni, pagamenti e fatture da un programma all'altro in automatico, con meno errori e senza aspettare che qualcuno trovi il tempo.

Cosa sono le API, spiegate con uno sportello

Pensa allo sportello di un ufficio pubblico. Non entri nell'archivio a cercare la tua pratica: compili un modulo con i campi previsti, lo consegni e ricevi una risposta. Ed è lo sportello a decidere chi può chiedere cosa.

Un'API funziona allo stesso modo, e ha sempre quattro elementi:

  • la richiesta: cosa vuoi, scritto nel formato previsto («gli ordini del 15 novembre»);
  • la risposta: i dati, sempre nello stesso formato, o un messaggio d'errore;
  • le regole: la documentazione, che dice quali richieste si possono fare e cosa si ottiene;
  • la chiave: il documento d'identità del programma, che stabilisce cosa può leggere e cosa modificare.

L'API però è solo la porta. Perché i dati passino davvero, serve un programma che bussa, legge, applica le tue regole e scrive dall'altra parte: è l'integrazione.

A cosa servono le API in azienda: quattro esempi

Negozio online e gestionale

WooCommerce, per esempio, ha delle REST API per leggere e modificare ordini, prodotti e clienti. Così gli ordini pagati entrano nel gestionale da soli e le giacenze tornano sul sito. Passaggi ed errori da evitare sono nell'articolo su come collegare e-commerce e gestionale.

Corriere

Anche i corrieri hanno le loro API. Nelle schede prodotto di Poste Delivery Business, ad esempio, i servizi web permettono di stampare le lettere di vettura, gestire i ritiri, seguire le spedizioni e gestire le giacenze direttamente dai sistemi del cliente. Il gestionale crea la spedizione quando l'ordine è pronto e riceve il numero di tracciamento, senza passare dal portale.

Banca: le API bancarie

Qui c'è di mezzo la legge. Con la direttiva europea sui servizi di pagamento (PSD2), recepita in Italia dal decreto legislativo 218/2017, se il conto è accessibile online hai diritto di farlo leggere a un prestatore autorizzato di servizi di informazione sui conti, che può lavorare solo con il tuo consenso esplicito. La banca deve comunicare in modo sicuro con questi servizi, e la Banca d'Italia segnala un rapido aumento delle chiamate API dell'open banking.

Per un'azienda vuol dire che saldo e movimenti possono arrivare in automatico al programma che li controlla. È un'informazione generale: quali servizi valgono per il tuo conto lo sa la tua banca.

Fatture elettroniche

Il Sistema di Interscambio dell'Agenzia delle Entrate riceve le fatture da quattro canali: PEC, invio via web, SDIFTP e SDICoop. Quest'ultimo è un servizio web per lo scambio automatico tra programmi e richiede un accreditamento. Nella nostra esperienza le piccole aziende non si accreditano quasi mai: il gestionale passa le fatture a un intermediario, che spesso ha a sua volta delle API, e riceve indietro le ricevute.

Prima e dopo: cosa cambia con le API

Processo Senza API Con un'integrazione via API
Ordini online Scaricati e ribattuti nel gestionale Entrano da soli appena pagati
Spedizioni Create sul portale del corriere, tracking copiato a mano Create dal gestionale, il tracking torna da solo
Movimenti bancari Estratto conto scaricato e spuntato riga per riga Arrivano al programma, si controllano solo le eccezioni
Fatture File caricati sul portale, ricevute controllate una a una Inviate dal gestionale, l'esito torna da solo

Quanto valga in ore e in euro dipende dai volumi: nell'articolo sul doppio inserimento dei dati trovi come fare il conto con i tuoi numeri, e le alternative quando un programma le API non le ha. Nella nostra esperienza, però, il guadagno più grande spesso non è il tempo: è che il dato arriva subito ed è uguale in tutti i programmi.

Cosa chiedere al fornitore del gestionale sulle API?

Non tutti i gestionali hanno le API, e non tutte le API sono uguali. Prima di progettare un collegamento, chiedi:

Domanda Perché conta
Esiste una documentazione, e posso vederla? Senza regole scritte, ogni integrazione è un tentativo
Quali dati si possono leggere e quali scrivere? Capita di poter leggere gli ordini ma non creare i documenti
Le API sono comprese nella licenza? A volte sono un modulo a parte
C'è un ambiente di prova? Le prove si fanno su dati finti, non sulle fatture vere
Ci sono limiti al numero di richieste? Con molti ordini, un limite basso rallenta tutto
Come vengono annunciati i cambiamenti? Un'API che cambia senza avviso rompe il collegamento

L'ultima domanda è la più sottovalutata. Shopify, per esempio, pubblica una nuova versione delle sue API ogni tre mesi e garantisce ogni versione stabile per almeno 12 mesi. Vuol dire che un'integrazione non si fa una volta per sempre: va seguita e aggiornata, come il resto del software.

Le API sono sicure?

Lo sono se le chiavi si trattano come password, perché di fatto lo sono: danno a un programma accesso ai tuoi dati, e nessuno lo vede lavorare. Qualche regola pratica:

  • permessi minimi: in WooCommerce una chiave si crea in sola lettura, sola scrittura o lettura e scrittura. Se un programma deve solo leggere gli ordini, non deve poterli modificare;
  • una chiave per ogni collegamento e per ogni fornitore, così si può revocare quella di uno senza fermare gli altri;
  • mai in chiaro nelle email o nei fogli condivisi;
  • revocarla subito quando un fornitore smette di lavorare per te o un collegamento non serve più.

Anche chi costruisce le API ha le sue responsabilità. Nella classifica dei dieci rischi principali per le API pubblicata da OWASP, la comunità internazionale che si occupa di sicurezza delle applicazioni, al primo posto ci sono le API che non controllano se chi chiede un certo dato ha il diritto di vederlo. All'ultimo c'è un errore di chi le usa: fidarsi dei dati che arrivano dalle API di altri più di quanto ci si fiderebbe di un utente. Per questo un'integrazione seria controlla quello che riceve prima di scriverlo nel gestionale.

Da dove partire

  1. Elenca i passaggi fatti a mano tra un programma e l'altro: ordini, spedizioni, banca, fatture.
  2. Scegli quello che pesa di più: il più frequente, o quello in cui un errore arriva al cliente.
  3. Chiedi ai fornitori dei due programmi se hanno le API e la documentazione, con le domande della tabella.
  4. Decidi chi comanda su ogni dato: un solo programma è la fonte, gli altri ricevono.
  5. Parti con un solo collegamento, misura il tempo risparmiato e solo dopo aggiungi gli altri.

In sintesi

Le API sono le porte ufficiali da cui i programmi si scambiano dati, con regole scritte e una chiave che dice chi può fare cosa. Negozio online, corriere, banca e Sistema di Interscambio le hanno già: spesso manca solo il collegamento con il gestionale. Prima di farlo chiedi documentazione, ambiente di prova e come vengono annunciati i cambiamenti, e tratta le chiavi come password.

Se vuoi una mano, in Touch Informatica colleghiamo i programmi che usi già attraverso le loro API, partendo dal passaggio che ti fa perdere più tempo. La prima consulenza è gratuita.