Blu7, azienda in corso di riconoscimento MIM per corsi in aula e online. Iscriviti a 7 Pillole Blu.
Prima o poi arriva in un preventivo, di solito in una riga che nessuno commenta: «integrazione via API», «costi API a consumo», «il gestionale espone le API». È una di quelle parole che chi le usa dà per scontate e chi le riceve non chiede, per non fare la figura di quello che non sa. Vale la pena chiarirla una volta, perché è la parola che decide se due programmi che avete in azienda si parleranno o no. E quanto vi costerà farli parlare.
Cosa è, senza gergo
Un’API è il modo in cui un programma parla con un altro programma senza nessuno davanti allo schermo.
L’immagine più onesta è il passavivande di una cucina. Il cameriere non entra in cucina, non tocca i fornelli e non sa come è fatto il risotto: passa un’ordinazione scritta in un formato che il cuoco capisce. Indietro riceve un piatto. L’API è quel passavivande: un elenco preciso di richieste che si possono fare e di risposte che si ottengono, senza che chi chiede debba sapere come funziona chi risponde.
Tutto quello che usate ogni giorno ne è pieno. Quando il vostro sito mostra le recensioni di Google, quando il gestionale emette una fattura elettronica, quando il negozio online comunica l’ordine al corriere: nessuno di questi passaggi ha una persona che copia e incolla. È il passavivande che lavora.
Perché vi riguarda, anche se non scrivete una riga di codice
Tre motivi molto pratici.
Decide se un software è una scatola chiusa. Un gestionale senza API è un posto dove i vostri dati entrano e non escono, se non a mano. Il giorno che vorrete cambiare fornitore, o collegarlo a qualcos’altro, la risposta sarà «si può fare, ma va sviluppato». Il giorno che lo comprate, invece, la domanda costa dieci secondi: le API ci sono, sono documentate, sono comprese nel prezzo? Sono tre domande, non una. Risposte diverse fra loro sono più comuni di quanto sembri.
Decide quanto costa l’intelligenza artificiale. Quando l’AI smette di essere una chat aperta sullo schermo e diventa qualcosa che lavora da solo (classifica le email in arrivo, prepara le schede prodotto, legge i documenti) il collegamento passa da lì, a consumo. È il punto in cui il prezzo per token smette di essere una curiosità e diventa una voce di bilancio: i conti sono in quanto costa l’intelligenza artificiale a token.
Decide dove finiscono i vostri dati. Un’integrazione via API manda pezzi di informazione a qualcun altro, in automatico, per sempre. Nel contratto va scritto quali dati escono, dove vanno a finire e per quanto restano lì. È una domanda che nessuno fa e che va fatta.
La novità degli ultimi due anni
Fino a poco fa ogni collegamento andava costruito su misura: il vostro gestionale, quel programma lì, uno sviluppatore che scrive il pezzo in mezzo. Adesso si sta diffondendo uno standard che permette agli assistenti AI di collegarsi agli strumenti aziendali in modo uniforme, senza un’integrazione nuova per ogni coppia di programmi. Ne abbiamo scritto in MCP: come un assistente AI si collega agli strumenti di lavoro.
Non cambia cosa sia un’API, cambia quanto costa metterne insieme dieci.
Le tre domande da fare a un fornitore
Copiatele pure così come sono, funzionano in qualunque trattativa.
- Il software espone delle API documentate? E la documentazione posso vederla prima di firmare? Se la documentazione è pubblica, è un buon segno. Se «la mandiamo dopo», meno.
- L’accesso è compreso o si paga a parte? Capita spesso che le API esistano ma stiano nel piano superiore, oppure che abbiano un limite di chiamate mensili facile da superare.
- Se domani cambio fornitore, con quale procedura porto via i miei dati? Un’API di lettura che restituisce tutto il vostro archivio in un formato standard è la vera assicurazione contro il rimanere prigionieri di un programma.
In una riga
Un’API è il passavivande fra due programmi: un elenco preciso di cose che si possono chiedere e di risposte che si ottengono, senza nessuno che copia e incolla. Non serve saperla usare, serve sapere se c’è, quanto costa e cosa lascia uscire. Sono le tre domande che separano un software che lavora per voi da uno in cui siete ospiti.
Blu7, azienda in corso di riconoscimento MIM per corsi in aula e online. Iscriviti a 7 Pillole Blu.