Webhook e API spiegati a chi non programma
Due parole che compaiono in ogni preventivo e che quasi nessuno si fa spiegare. Cosa sono un'API e un webhook, in italiano, con un paragone che regge: sapere la differenza cambia le domande che fai al fornitore.
Se hai ricevuto un preventivo per un software negli ultimi anni, dentro c'erano quasi certamente le parole «API» e «webhook». E quasi certamente nessuno te le ha spiegate, perché chi le usa tutti i giorni dimentica che non sono italiano corrente.
Non serve sapere come funzionano dentro. Serve sapere cosa permettono di fare, perché da quello dipendono domande molto concrete: questo software può parlare con quell'altro? Quanto in fretta? Chi se ne accorge se smette?
L'API: una porta di servizio
Immagina un ristorante. I clienti entrano dalla porta principale e vedono la sala: è l'interfaccia, quella con i bottoni, che usano le persone.
Poi c'è una porta di servizio sul retro, dove il fornitore consegna la merce. Non è bella, non ha un'insegna, ma è fatta apposta perché qualcuno ci passi in modo ordinato. Quella è l'API: una porta che un software apre per farsi interrogare da altri software, con regole precise su cosa si può chiedere e come.
Quando il tuo e-commerce «passa gli ordini al gestionale», sta bussando a quella porta. La domanda utile da fare a un fornitore è semplicissima: «il vostro software ha delle API documentate?». Se la risposta è sì, collegarlo a qualcos'altro in futuro sarà un lavoro normale. Se è no, ogni collegamento sarà un'acrobazia.
Il webhook: il campanello
Con l'API sei tu a chiedere: «ci sono ordini nuovi?». Puoi farlo ogni ora, ogni cinque minuti, ma comunque stai chiedendo, e nel frattempo non sai niente.
Il webhook ribalta la direzione: è un campanello che lasci a chi ha l'informazione, dicendogli «suona qui quando succede». Quando arriva un ordine, il sistema chiama il tuo e ti passa subito il dato, senza che tu debba controllare.
La differenza si sente in due cose: la velocità — un webhook è immediato, un controllo periodico ha sempre un ritardo — e il carico, perché chiedere mille volte al giorno «ci sono novità?» per ricevere novità tre volte è lavoro sprecato per entrambi.
| API | Webhook | |
|---|---|---|
| Chi comincia | Tu chiedi | L'altro ti avvisa |
| Tempi | Quando controlli | Appena succede |
| Tipico uso | Leggere l'anagrafica clienti | Ordine ricevuto, pagamento riuscito |
| Se l'altro è spento | Te ne accorgi subito | L'avviso va perso, se nessuno riprova |
La parte che conta davvero: cosa succede quando salta
Qui sta la domanda che separa un'integrazione seria da una fragile, e la puoi fare anche senza sapere niente di tecnico: «se il webhook non arriva, cosa succede?».
Le connessioni cadono, i server si riavviano, le manutenzioni capitano. Un sistema fatto bene riprova più volte, tiene traccia di cosa non è arrivato e, se proprio non ce la fa, avvisa una persona. Un sistema fragile perde l'avviso in silenzio: e tu scopri tre giorni dopo che gli ordini del sito non entrano più in magazzino.
La seconda domanda utile è sulla sicurezza: «come fate a sapere che il campanello l'ha suonato davvero chi dice di essere?». Esistono modi standard per verificarlo. Se nessuno ci ha pensato, chiunque conosca l'indirizzo può far finta di essere il sistema dei pagamenti.
Perché ti conviene saperlo
Non per diventare tecnico, ma per fare tre domande al momento giusto, prima di firmare: il software ha API documentate, manda webhook per gli eventi che contano, e cosa succede quando qualcosa non arriva.
Sono tre domande che cambiano il valore di quello che compri, perché decidono se fra due anni potrai collegarlo a qualcos'altro o se sarai chiuso dentro. È lo stesso ragionamento che vale per i dati e per gli accessi: quello che conta è restare in grado di muoversi.
Se hai un preventivo davanti e ci trovi queste parole, mandamelo pure: ti traduco cosa vuol dire in pratica per il tuo caso e quali domande farei prima di firmarlo.
