API cosa sono: perché due programmi si parlano e cosa chiedere al fornitore
Perché il gestionale e il CRM non si scambiano nulla da soli? Spesso la risposta sta in tre lettere. Cosa sono le API e cosa chiedere a chi te le vende.
API cosa sono: la porta che un programma apre agli altri
Un'API è la porta con cui un programma permette a un altro di chiedergli informazioni o di fargli eseguire un'operazione, secondo regole scritte. Il gestionale non si apre a chiunque: accetta richieste precise («dammi l'ordine 1042», «crea questo cliente») e risponde in modo prevedibile. Se quella porta non esiste, i due programmi non si parlano direttamente.
Il nome sta per Application Programming Interface, ma il nome serve a poco. Pensa a un ristorante: tu non entri in cucina a cercare gli ingredienti, ordini al cameriere, il cameriere porta la richiesta e torna con il piatto. L'API è il cameriere. Sa quali ordini può prendere (il menu), in che forma vanno fatti, e cosa ti riporta indietro. Se ordini qualcosa che non è sul menu, ricevi un errore, non un piatto a sorpresa.
Quando un titolare dice «vorrei che il CRM sapesse quello che succede nel gestionale», sta chiedendo, senza saperlo, che esista un'API da una parte e qualcuno che la chiami dall'altra.
Come funziona una richiesta, con un esempio che puoi toccare
Prendi un ordine che arriva dal tuo e-commerce B2B. Il sito ha bisogno di sapere se l'articolo è disponibile. Manda una richiesta al gestionale: codice articolo, quantità. Il gestionale risponde: disponibili 12, consegna in tre giorni. Il sito mostra il messaggio al cliente, e nessuno ha aperto un file.
Di solito ogni richiesta ha quattro pezzi, e basta conoscere questi:
- L'indirizzo a cui bussare, cioè dove vive quella funzione.
- L'azione: leggere, creare, modificare, cancellare.
- La chiave che dimostra che hai il permesso di chiedere.
- La risposta, di solito in un formato testuale ordinato (JSON), con un codice che dice se è andata bene.
Quel codice è la parte che interessa a chi gestisce il collegamento. Un 401 vuol dire che la chiave non è valida o è scaduta. Un 404, che quello che cerchi non esiste (l'ordine è stato cancellato, o l'indirizzo è sbagliato). Un 429, che hai chiesto troppe volte in poco tempo e il fornitore ti ha messo in pausa. Quando un automatismo «ha smesso di funzionare», quasi sempre la spiegazione sta in una di queste tre righe, e chi non le vede perde ore a cercare altrove.
Non devi saper scrivere una richiesta. Devi saper riconoscere se l'API esiste, se è documentata e se chi te la offre la tiene in piedi.
Cosa sono le web API e i servizi API
Le web API sono semplicemente API raggiungibili via internet, con le stesse regole con cui il browser apre una pagina. Oggi la maggior parte dei collegamenti fra programmi in cloud passa da lì. Quando senti parlare di «servizi API» di solito si intende un fornitore che mette a disposizione una funzione attraverso un'API: un sistema di pagamento, un corriere che restituisce lo stato di una spedizione, un modello di intelligenza artificiale che riceve un testo e ne restituisce un altro.
C'è una distinzione che ti farà risparmiare confusione. L'API risponde quando tu chiedi. Se invece vuoi che sia l'altro programma ad avvisarti nel momento in cui succede qualcosa (un pagamento arrivato, un ordine cambiato di stato), si usa un meccanismo complementare, spiegato in webhook cos'è e come funziona in azienda. Nella pratica li trovi spesso insieme.
Perché due programmi non si parlano
Quando due strumenti aziendali non comunicano, le cause sono poche e quasi sempre noiose.
La prima: l'API non c'è. Succede con programmi vecchi o chiusi, e lì l'unica uscita è un'esportazione manuale, il file che qualcuno scarica ogni mattina e carica da un'altra parte. La seconda: c'è, ma è nel piano più caro, o si paga a parte. La terza: c'è, ma copre metà delle funzioni, tipicamente la lettura sì e la scrittura no, cioè puoi guardare gli ordini ma non crearli. La quarta: esiste e funziona, ma nessuno l'ha mai collegata, perché serve qualcuno che lo faccia.
L'ultimo caso è il più frequente e il più frustrante: qualcuno in ufficio ricopia a mano da un programma all'altro, ogni giorno, convinto che «i sistemi non si integrano». Spesso si integrano benissimo, solo che nessuno ha costruito il ponte. Se ti riconosci, il lavoro è quello descritto nella pagina sulle automazioni su misura con n8n, Python e AI: si parte da chi esegue il processo, non da chi lo racconta.
E quando l'API proprio non c'è? Esiste un piano B, il software che simula i clic di una persona sullo schermo. Funziona, ma è fragile: cambia un pulsante e si rompe. Ne parliamo in RPA cos'è e quando basta un'API. La regola è semplice: se l'API c'è, usala. Il robot che clicca è l'ultima scelta, non la prima.
Perché le API sono importanti per un'azienda
Non per la tecnologia in sé. Contano perché spariscono le ricopiature, e con loro gli errori di ricopiatura, e perché le informazioni arrivano nel momento in cui servono, non il giorno dopo.
Un esempio dalle nostre automazioni pubblicate (pagina Automazioni di liberatori.eu, primi novanta giorni dal lancio): un e-commerce B2B da 1.200 ordini al mese, con gestionale, corriere e CRM sincronizzati, ha il 98% degli ordini senza tocco umano, e il lavoro è passato da quattro persone a una. Per tenere allineati tre sistemi così servono le API di ciascuno, con qualcuno che le abbia collegate bene.
Vale anche per la parte commerciale. Un modulo sul sito che finisce nel CRM, viene assegnato al commerciale giusto e genera un promemoria è una catena di chiamate fra programmi. Il percorso completo lo trovi in automazione gestione lead: dal modulo al commerciale giusto.
Cosa chiedere a un fornitore prima di fidarti
Qui i titolari spesso si accontentano di un «sì, abbiamo le API». È come chiedere a un ristorante se ha una cucina. Le domande utili sono altre:
- La documentazione è pubblica? Se te la mostrano solo dopo la firma, diffida. Una buona documentazione si legge prima, anche da chi poi la userà per te.
- Quali operazioni copre? Chiedi caso per caso: posso leggere gli ordini, crearli, aggiornarli? Fatti rispondere sulle tue operazioni, non su un elenco generico.
- Quanto costa usarla? Inclusa nel canone, a consumo, a pacchetti? Molti servizi mettono un tetto alle chiamate al minuto o al giorno: se il tuo flusso lo supera, si ferma.
- Che permessi ha la chiave? Si possono creare chiavi limitate, per esempio di sola lettura? Una chiave che fa tutto, finita nelle mani sbagliate, fa danni. Trattala come una password: mai nelle email, mai in un foglio condiviso.
- Esiste un ambiente di prova? Collegare un programma ai tuoi ordini veri al primo tentativo è il modo migliore per rovinarsi un pomeriggio.
- Cosa succede quando cambiano le regole? Le API hanno versioni. Chiedi con quanto preavviso vengono spente quelle vecchie e come vieni avvisato.
- Cosa vedo quando qualcosa va storto? Un registro delle richieste e degli errori, in chiaro. Senza, ogni guasto diventa uno scarico di responsabilità fra te, il fornitore e chi ha fatto il collegamento.
Una nota sul tuo fronte. Il collegamento, una volta costruito, va tenuto acceso: qualcuno deve accorgersi che una chiave è scaduta o che il fornitore ha cambiato qualcosa. Prima di commissionarlo, decidi chi se ne occupa e dove vive. Cosa chiedere a chi lo gestisce l'abbiamo scritto in infrastruttura gestita: cosa resta tuo e cosa chiedere.
Come verificare in dieci minuti se il tuo programma ha un'API
Non serve un tecnico per la prima occhiata.
- Cerca nel sito del fornitore le parole «API», «developer» o «documentazione». Se non trovi niente, è già un'informazione.
- Guarda se esiste un elenco di operazioni con esempi di richiesta e risposta. Quello è il menu del cameriere.
- Scrivi al supporto con una domanda sola, concreta: «posso creare un ordine da un altro programma, e a quali condizioni?»
- Annota la risposta con la data e il nome di chi l'ha data. Fra sei mesi ti servirà.
Diffida delle risposte vaghe del tipo «lo fa il nostro partner». Può essere vero, ma allora il costo non è zero e va messo sul tavolo subito.
Il primo passo
Scegli i due programmi che oggi costringono qualcuno a ricopiare a mano, e scrivi al fornitore di ciascuno le stesse tre domande: la documentazione è pubblica, la chiave può essere limitata, quanto costa usarla. Con le risposte in mano sai già se il ponte si può costruire così com'è o se prima va cambiato uno dei due pezzi.
Domande frequenti
Che cosa sono le API in parole semplici?
Sono le regole con cui un programma accetta richieste da un altro: chiedi un'informazione o un'operazione e ricevi una risposta prevedibile. Funzionano come un cameriere fra te e la cucina.
Cosa sono le web API?
Sono API raggiungibili via internet, con le stesse regole con cui il browser apre una pagina. Sono la forma più usata per collegare gestionali, CRM, e-commerce, pagamenti e servizi di intelligenza artificiale.
Come faccio a sapere se il mio gestionale ha le API?
Cerca «API» o «documentazione» sul sito del fornitore e chiedi al supporto se puoi creare e leggere gli ordini da un altro programma. Fatti rispondere per iscritto, con costi e limiti.