Che cos’è un’API? Guardane una in azione

Quasi ogni registrazione a uno strumento AI nel 2026 fa comparire le stesse tre lettere: API. ChatGPT, generatori di immagini, estrattori web, integrazioni CRM — il termine è ovunque, eppure la maggior parte delle spiegazioni parte dalla solita, stanca analogia del ristorante e non mostra mai davvero com’è fatta un’API. Questo articolo è diverso. Nel giro di poche sezioni vedrai una vera richiesta API, una vera risposta e capirai perché il tuo team commerciale, il tuo flusso operativo e il tuo stack ecommerce dipendono dalle API ogni singolo giorno.

Ho passato molto tempo in a pensare a come rendere i concetti tecnici accessibili ai team business — persone che non scrivono codice ma devono assolutamente capire come i loro strumenti comunicano tra loro. Così ho approfondito la ricerca, testato chiamate API live e messo insieme questa guida per darti quell’esperienza da “fammi vedere, non solo raccontare” che la maggior parte delle spiegazioni sulle API salta. Rappresentanti commerciali, responsabili marketing, operatori ecommerce — qui trovi davvero ciò che ti serve.

Che cos’è un’API? Definizione in parole semplici

Un’API (Application Programming Interface) è un insieme di regole che permette a un software di chiedere dati o un’azione a un altro software e ricevere in cambio una risposta strutturata.

Detto in altro modo, è il punto di contatto ufficiale tra due sistemi. Non accedi all’intero database, all’intera app o all’intera azienda che ci sta dietro. Accedi solo alle parti esposte dall’API, nel formato che si aspetta, e ricevi esattamente ciò che promette. , e convergono tutti su questo punto: un’API è un meccanismo o un contratto che consente ai componenti software di comunicare usando regole e protocolli definiti.

Pensa a uno sportello drive-through. Fai il tuo ordine in un formato specifico (un piatto del menu, una dimensione, magari una personalizzazione) e ricevi esattamente ciò che hai chiesto — senza entrare mai in cucina. Il menu è la documentazione dell’API. Lo sportello è l’endpoint. Lo scontrino è la risposta.

Ma le analogie arrivano solo fino a un certo punto. Ecco com’è fatto davvero una chiamata API.

Come appaiono una vera richiesta e una vera risposta API

Incolla subito questo URL nel browser:

1https://api.agify.io?name=michael

Hai appena inviato una richiesta GET all’API di Agify, chiedendole di prevedere l’età associata al nome "michael". Ecco cosa riceverai in risposta (una risposta JSON):

1{
2  "count": 304886,
3  "name": "michael",
4  "age": 61
5}

Tutto qui. Hai appena fatto una chiamata API. Niente codice, niente terminale, niente installazione. La richiesta era l’URL (con un parametro) e la risposta erano dati strutturati che il browser ha mostrato come testo. Ogni API funziona con questo principio di base: richiesta strutturata in ingresso, risposta strutturata in uscita.

Cosa un’API NON è

Un’API non è un database. È il livello di accesso controllato che si trova davanti a un database (o a un servizio, o a un modello).

Un’API non è un sito web. Un sito è progettato per essere letto e cliccato dagli esseri umani. Un’API è progettata per essere letta e trattata dal software — restituisce dati strutturati (di solito JSON), non pagine visive.

Un’API non è hacking. Accede solo ai dati e alle azioni che il provider ha scelto intenzionalmente di rendere disponibili.

Perché i team business dovrebbero interessarsi alle API?

Se lavori in sales, operations, marketing o ecommerce, forse non scriverai mai una richiesta API da solo. Ma usi continuamente software connessi via API — e capire il concetto ti dà un vantaggio concreto quando valuti strumenti, progetti automazioni e comunichi con il team dev.

Le API sono già intrecciate nel tuo lavoro quotidiano — ecco dove:

L’effetto netto: meno inserimento manuale di dati, meno errori e processi che prima richiedevano ore e ora si chiudono in pochi secondi. Il ha rilevato che il degli intervistati genera oggi ricavi direttamente dalle API — contro il 28% dell’anno precedente. E il dichiara di essere "API-first", cioè che le API vengono progettate e testate prima delle applicazioni che ne dipendono.

La prossima volta che valuti uno strumento SaaS, fai una domanda: ha un’API e cosa espone? Una sola domanda può farti risparmiare mesi di grattacapi di integrazione.

Come funziona un’API? Spiegazione del ciclo richiesta-risposta

Il modello è sempre lo stesso:

1. Tu (il client) invii una richiesta — "Ehi, dammi il meteo di New York."
2. L’API riceve la richiesta, controlla se è valida e autorizzata e la instrada al server giusto.
3. Il server elabora la richiesta — interroga un database, esegue un modello o compie un’azione.
4. L’API invia indietro una risposta — dati strutturati (di solito JSON) con la soluzione, più un codice di stato che ti dice cosa è successo.

Un modo semplice per visualizzarlo:

Client → invia richiesta (metodo + endpoint + header + body) → endpoint API → Server elabora → endpoint API → invia risposta (codice di stato + body JSON) → Client

Termini chiave che userai davvero

Fonte: , , .

Una richiesta vaga viene rifiutata. Una richiesta valida include endpoint, metodo, permessi e campi corretti. Una buona documentazione API è il manuale di istruzioni su cosa puoi chiedere e su come farlo.

API vs SDK vs Webhook vs Libreria: qual è la differenza?

I vendor adorano lanciare "API", "SDK", "webhook" e "libreria" come se fossero sinonimi. Non lo sono. Ho passato abbastanza di queste call per sapere che la confusione è reale. Ecco la tabella chiarificatrice che avrei voluto mi dessero anni fa:

Un po’ di contesto in più su ciascuno:

• SDK: se stai costruendo un’app mobile, l’SDK ti dà tutto — API, codice di esempio, documentazione, utility. Probabilmente non incontrerai gli SDK se non lavori con sviluppatori.
• Libreria: una libreria è codice scritto da altri che puoi usare dentro il tuo programma. Può usare API sotto il cofano, ma è uno strumento per sviluppatori, non un canale di comunicazione tra sistemi.
• Webhook: invece di chiedere all’API gli aggiornamenti ("Il pagamento è già passato? E adesso?"), un webhook ribalta il modello — il server ti invia una notifica quando l’evento accade. Pensalo come una notifica push per il software.

Quando nel 2026 si dice "API", quasi sempre si intende una web API — in particolare una REST API. Ma conoscere questi termini correlati significa non perdersi in una presentazione commerciale o in una chat Slack con il team engineering.

I principali tipi di API (e quando li incontrerai)

In base al livello di accesso

• API pubbliche (aperte): chiunque può usarle. Esempio: un’API meteo gratuita o un’API di dati pubblici come .
• API private (interne): usate solo all’interno di un’azienda per collegare sistemi interni. Esempio: il tuo CRM che comunica con il sistema di fatturazione.
• API partner: condivise solo con partner commerciali specifici in base ad accordi. Esempio: un’azienda logistica che condivide i dati di tracciamento delle spedizioni con i retailer.

In base all’architettura

Fonte: , , .

Come utente business, interagirai soprattutto con API REST e webhook. Il resto è utile da conoscere per le conversazioni con i vendor, ma REST è il punto di partenza predefinito per la documentazione SaaS, le integrazioni Zapier e strumenti come Thunderbit.

API AI nel 2026: il caso d’uso che ha cambiato tutto

Gli articoli più vecchi su "che cos’è un’API" fanno finta che il primo incontro di tutti con le API sia Google Maps o Stripe. Nel 2026 non è così. La maggior parte dei principianti incontra la parola "API" perché si è iscritta a ChatGPT, ha provato un generatore di immagini o ha esplorato uno strumento di scraping AI.

Dal punto di vista tecnico, un’API AI funziona come qualsiasi altra API. Invi una richiesta — un prompt, un documento, un URL — e ricevi un output strutturato. La differenza è lato server: invece di cercare una riga in un database, il server esegue un modello.

Esempi reali:

• API di OpenAI: invii un prompt testuale → ricevi una risposta generata dall’AI.
• API di generazione immagini: invii una descrizione → ricevi un’immagine generata dall’AI.
• API di estrazione dati AI: invii una pagina web disordinata → ricevi dati puliti e strutturati.

Come l’Open API di Thunderbit trasforma pagine web disordinate in dati strutturati

Ora veniamo alla parte su cui sono di parte (per ovvie ragioni). offre un’Open API che rende programmabile l’estrazione dati basata sull’AI:

• Distill API: invii l’URL di una pagina web → ricevi Markdown pulito, pronto per l’analisi o per pipeline AI. Ottima per l’analisi dei contenuti, la costruzione di knowledge base o per alimentare flussi di lavoro con LLM.
• Extract API: definisci uno schema (nomi dei campi, tipi) e invii un URL → l’AI estrae dati JSON strutturati che corrispondono al tuo schema.

Ecco un esempio semplificato. Immagina di inviare l’URL di una pagina prodotto Amazon disordinata all’Extract API di Thunderbit:

1POST https://api.thunderbit.com/v1/extract
2Authorization: Bearer YOUR_API_TOKEN
3Content-Type: application/json
4{
5  "url": "https://example-store.com/products",
6  "fields": [
7    { "name": "product_name", "type": "text" },
8    { "name": "price", "type": "number" },
9    { "name": "rating", "type": "number" }
10  ]
11}

E ricevi:

1{
2  "status": "success",
3  "data": [
4    { "product_name": "Organic Cotton Tee", "price": 29.99, "rating": 4.7 },
5    { "product_name": "Linen Button Shirt", "price": 54.00, "rating": 4.5 }
6  ]
7}

Quella risposta è pronta per un foglio di calcolo. Una sola chiamata API ha sostituito ore di copia e incolla manuale. L’ usa lo stesso motore AI dietro un’interfaccia no-code, ma l’API lo apre ai team che devono automatizzare su larga scala.

Per saperne di più su come funziona l’estrazione AI nella pratica, leggi la nostra guida su oppure .

La tua prima chiamata API: mini tutorial pratico

Due minuti. Niente download, niente installazioni, niente codice. Pronto?

Passo 1: apri il browser

Apri una nuova scheda del browser.

Passo 2: incolla un URL API gratuito

Copia e incolla questo nella barra degli indirizzi e premi Invio:

1https://api.agify.io?name=michael

Hai appena inviato una richiesta GET all’API di Agify, chiedendole di prevedere l’età associata al nome "michael."

Passo 3: leggi insieme la risposta JSON

Dovresti vedere qualcosa del genere:

1{
2  "count": 304886,
3  "name": "michael",
4  "age": 61
5}

• "name" — l’input che hai fornito
• "age" — la previsione dell’API
• "count" — quanti punti dati ha usato

Tutto qui. Hai appena fatto una chiamata API.

Passo 4: fai un salto di livello — prova un’API con autenticazione tramite chiave

Ora prova qualcosa di un po’ più realistico. Vai su , registrati per un account gratuito e ottieni una chiave API. Poi incolla un URL come questo (sostituendo YOUR_KEY):

1https://api.openweathermap.org/data/2.5/weather?q=London&appid=YOUR_KEY&units=metric

Questa volta hai dovuto dimostrare chi sei con una chiave API. Questa è autenticazione — ed è così che funzionano la maggior parte delle API reali.

Passo 5: capire i codici di risposta

Quando fai chiamate API, a volte vedrai errori invece dei dati. Ecco cosa significano i codici di stato più comuni:

Fonte: .

Sicurezza API spiegata in modo semplice: chiavi, OAuth e JWT in una tabella

Hai già usato due livelli di autenticazione senza pensarci: nessuna autenticazione (Agify) e chiave API (meteo). Gli altri due metodi completano il quadro:

Fonte: , .

Quando hai incollato quell’URL di Agify, non hai usato alcuna autenticazione. Quando hai aggiunto la chiave API del meteo, hai usato l’autenticazione tramite chiave. OAuth e JWT entrano in gioco quando le app devono accedere ai tuoi dati personali — ad esempio quando fai clic su "Accedi con Google."

L’estensione Chrome di Thunderbit usa la sessione già autenticata del browser (non serve una chiave API separata per lo scraping), mentre l’Open API di Thunderbit usa la normale autenticazione tramite Bearer token. È un esempio pratico di entrambi i modelli in un solo prodotto.

Come mantenere al sicuro le chiavi API

• Non condividere mai la tua chiave API pubblicamente (niente screenshot, niente documenti condivisi, niente repository pubblici).
• Non inserire le chiavi in documenti o fogli di calcolo condivisi.
• Se sei uno sviluppatore, usa variabili d’ambiente o un secrets manager.
• Ruota periodicamente le chiavi, e subito se sospetti un’esposizione.

Esempi reali di API che usi già ogni giorno

Probabilmente hai usato mezza dozzina di API prima di pranzo oggi senza accorgertene:

• Google Maps incorporato in un sito aziendale: il sito usa l’API di Google Maps per recuperare e mostrare la mappa. Tu vedi una mappa; dietro le quinte, una chiamata API l’ha recuperata. Fonte: .
• "Accedi con Google/Facebook": API basate su OAuth che ti consentono di accedere senza creare un nuovo account.
• Elaborazione dei pagamenti (Stripe, PayPal): quando fai checkout online, un’API gestisce il pagamento tra il negozio e il fornitore di pagamenti. Fonte: .
• App meteo: l’app meteo del tuo telefono chiama un’API meteo ogni volta che la apri.
• Chatbot e assistenti AI: ChatGPT, Claude e gli strumenti di scraping AI espongono tutte le loro funzionalità tramite API.
• Motore di raccomandazione di Spotify: quando Spotify suggerisce una playlist, dietro le quinte le API stanno fornendo dati sui brani, preferenze utente e previsioni del modello.
• AI Web Scraper di Thunderbit: usa l’AI per — e ora offre anche un’Open API così i team possono automatizzare l’estrazione dati su larga scala.

Come scegliere l’API giusta per le esigenze della tua azienda

Quando è il momento di scegliere un’API — o di aiutare il tuo team dev a sceglierne una — questi sono i criteri che vale la pena considerare:

Un confronto rapido:

Il ha rilevato che l’azienda media gestisce , con che ne gestisce almeno 500. Sono tanti elementi in movimento — ed è per questo che documentazione, supporto e prezzi chiari contano così tanto.

API e inserimento dati automatizzato: dove il concetto diventa pratico

Le API diventano davvero interessanti quando le applichi alla parte più noiosa di qualsiasi workflow aziendale: l’inserimento dati.

e — che sembra poco finché non ti rendi conto che, in un dataset da 10.000 record, sono 100 errori. In finanza, sanità o ecommerce, anche pochi errori possono far saltare un deal o generare problemi di compliance.

I sistemi di inserimento dati automatizzato combinano API con OCR, AI e machine learning per acquisire, estrarre, validare ed esportare dati — senza che una persona debba copiare e incollare tra schede diverse. Di solito il flusso di lavoro è questo:

1. Acquisizione dei dati: il sistema legge i dati da una fonte (una pagina web, un PDF, un’immagine o un modulo).
2. Estrazione: AI o OCR identificano e estraggono i campi rilevanti.
3. Validazione: regole che controllano errori, duplicati o valori mancanti.
4. Esportazione: i dati puliti confluiscono in un foglio di calcolo, CRM, ERP o database — spesso tramite API.

Thunderbit si inserisce in questo flusso come livello di estrazione basato sull’AI. Con l’, un utente business può aprire una pagina web, fare clic su "Suggerisci campi con AI" e lasciare che l’AI capisca quali colonne estrarre — . I dati vengono esportati direttamente in Excel, Google Sheets, Airtable o Notion. E per i team che devono automatizzare su larga scala, l’Open API di Thunderbit trasforma la stessa AI in un endpoint programmabile.

Per esempi reali di come funziona l’inserimento dati automatizzato nella pratica, consulta il nostro post su o sui .

FAQ

1. Che cosa significa API?

API sta per Application Programming Interface. È un insieme di regole che permette a due programmi software di comunicare — uno chiede dati o un’azione e l’altro risponde in un formato strutturato.

2. Devo saper programmare per usare un’API?

Non necessariamente. Molte API possono essere chiamate da un browser, da Postman o da strumenti no-code come Zapier. Strumenti come l’estensione Chrome di Thunderbit usano le API dietro le quinte senza richiedere alcun codice. L’Open API è programmatica, ma i team business possono usarla tramite strumenti interni o piattaforme di automazione.

3. Un’API è la stessa cosa di un sito web?

No. Un sito web è progettato per essere letto e cliccato dalle persone. Un’API è progettata per essere letta dai programmi — restituisce dati strutturati (come JSON), non pagine web visive. Spesso vivono nello stesso dominio, ma servono scopi molto diversi.

4. Le API sono gratuite?

Alcune sì (come le API di dati pubblici). Altre usano modelli freemium (piano gratuito + piani a pagamento) oppure fanno pagare per richiesta. L’Open API di Thunderbit, per esempio, usa un sistema a crediti con un piano gratuito per i test. Controlla sempre prezzi, limiti di richiesta e termini di servizio di ogni provider.

5. Qual è la differenza tra una chiave API e OAuth?

Una chiave API è una singola stringa segreta da includere in ogni richiesta — semplice e adatta agli accessi di base. OAuth 2.0 è un flusso più complesso in cui l’utente concede a un’app un permesso limitato (come "Accedi con Google"), così l’app può accedere a dati specifici senza mai vedere la password dell’utente. Le chiavi API identificano l’app; OAuth concede permessi utente con ambiti limitati.

Scopri di più