Cos'è un SDK? Kit di sviluppo software spiegati semplicemente

Un SDK (software development kit) è un toolkit pronto che un'azienda mette a disposizione degli sviluppatori per usare il suo servizio o la sua piattaforma senza costruire tutto da zero. Di solito include una libreria di codice per un linguaggio di programmazione specifico, documentazione ed esempi, e a volte strumenti extra come utility per i test. Quando la tua app «usa l'SDK di Stripe», significa che il tuo codice chiama le funzioni già pronte di Stripe invece di scrivere a mano ogni richiesta alla sua API.

Perché gli SDK contano quando costruisci con l'AI

Quando chiedi a un AI builder di aggiungere pagamenti, chat AI, mappe o email, di solito installa l'SDK di quel fornitore e scrive qualche riga che lo chiama. Sapere cos'è un SDK ti aiuta a:

• Capire cosa viene aggiunto al progetto. Un SDK è una dipendenza — codice esterno da cui la tua app ora dipende.
• Riconoscere la configurazione necessaria. Quasi ogni SDK richiede una chiave API, e molti hanno versioni separate per «server» e «browser» con regole diverse su quali chiavi si possono usare in sicurezza.
• Chiedere la cosa giusta. «Usa l'SDK ufficiale di Stripe sul server» è un'istruzione più chiara di «aggiungi Stripe».
• Leggere gli errori. Molti errori nelle app costruite con l'AI derivano da un SDK configurato male, non aggiornato o usato nel posto sbagliato.

Un'analogia quotidiana

Immagina di voler montare delle mensole.

• L'API sono le regole del palazzo: quali pareti reggono le viti, quale peso sopportano, dove passano le tubature. Potresti lavorare con sole queste regole, misurando e forando tutto da solo.
• L'SDK è il kit di mensole in pacco piatto della stessa azienda che ha costruito quelle pareti: pezzi già tagliati, le viti giuste, una staffa che si adatta esattamente alle loro pareti e un libretto di istruzioni.

Decidi ancora tu dove va la mensola e cosa ci metti sopra. Il kit ti evita di tagliare il legno e di indovinare la misura delle viti — e rende meno probabile finire con un foro in una tubatura.

SDK vs API vs libreria vs framework

Questi termini si sovrappongono, e confondono molte persone:

Un SDK di solito contiene una libreria, e quella libreria di solito chiama un'API. Per un servizio web, «SDK» e «client library» vengono spesso usati come sinonimi.

Alcuni SDK non riguardano affatto i servizi web. Apple e Google pubblicano SDK per costruire app iOS e Android, che includono compilatori, simulatori e codice della piattaforma. L'idea è la stessa: tutto ciò che serve per sviluppare per la loro piattaforma, in un solo kit.

Cosa fa un SDK per te

Ecco lo stesso compito — creare un cliente presso un fornitore di pagamenti — svolto in due modi.

Senza SDK, il tuo codice deve costruire da sé la richiesta HTTP: impostare l'URL, aggiungere la chiave segreta nell'header giusto, formattare i dati come li si aspetta l'API, inviarli, controllare il codice di stato, interpretare la risposta e gestire i nuovi tentativi se la rete va a intermittenza.

Con un SDK, è vicino a una sola riga:

const customer = await stripe.customers.create({ email: "lena@example.com" });

Dietro quella riga, l'SDK gestisce:

• Autenticazione — allegare correttamente la tua chiave a ogni richiesta
• Formattazione dei dati — convertire i tuoi dati in ciò che l'API si aspetta, e la risposta di nuovo in oggetti
• Errori — trasformare i codici di stato in tipi di errore chiari che il tuo codice può intercettare
• Nuovi tentativi — riprovare in sicurezza quando una richiesta fallisce per motivi temporanei (molti SDK ufficiali lo fanno)
• Tipi — in TypeScript, indicare al tuo editor quali campi esistono, così gli errori emergono prima di eseguire il codice

Un esempio pratico: aggiungere risposte AI a un'app di assistenza

Chiedi a un AI builder: «Quando un cliente invia un ticket di assistenza, genera una risposta suggerita usando un modello AI.»

1. L'AI installa l'SDK ufficiale del fornitore del modello come pacchetto nel progetto (nei progetti JavaScript, dal registro npm).
2. Aggiungi la chiave API del fornitore come segreto del progetto. L'SDK la legge da una variabile d'ambiente sul server.
3. L'AI scrive una route del server che chiama l'SDK con il testo del ticket e una breve istruzione, e salva la risposta suggerita nel database.
4. Il browser non vede mai la chiave; chiama solo la route del tuo server.

Se in futuro il fornitore cambia la sua API, di solito rilascia una nuova versione dell'SDK. Aggiornare il pacchetto — e controllare le note di rilascio per le modifiche che rompono la compatibilità — spesso è tutto ciò che serve.

Termini chiave

Idee sbagliate comuni

• «SDK e API sono la stessa cosa.» L'API è l'interfaccia del servizio; l'SDK è uno strato di comodità sopra di essa. Puoi chiamare la maggior parte delle API web senza SDK — è solo più lavoro.
• «Se l'SDK è installato, l'integrazione è fatta.» Ti servono ancora un account presso il fornitore, le chiavi giuste e codice che gestisca ciò che succede quando qualcosa va storto.
• «Qualsiasi pacchetto con il nome giusto è quello ufficiale.» Gli aggressori a volte pubblicano pacchetti con nomi simili. Controlla nella documentazione del fornitore il nome esatto del pacchetto.
• «L'SDK per il browser può usare la mia chiave segreta.» Mai. Tutto ciò che è nel codice del browser è visibile ai visitatori. Le chiavi segrete vanno solo nel codice lato server — vedi come proteggere le chiavi API.
• «Gli SDK non hanno mai bisogno di aggiornamenti.» Le vecchie versioni smettono di ricevere correzioni e alla fine smettono di funzionare quando i fornitori ritirano le vecchie versioni dell'API.

Cosa chiedere al tuo AI builder

• «Usa l'SDK ufficiale del fornitore, non un wrapper di terze parti. Dimmi il nome esatto del pacchetto e la versione installata.»
• «Usa l'SDK solo sul server e leggi la chiave da una variabile d'ambiente.»
• «Quali parti di questo SDK vengono eseguite nel browser, e quali chiavi usano?»
• «Cosa succede se la chiamata all'SDK fallisce o va in timeout? Mostra all'utente un messaggio chiaro e registra l'errore.»
• «Elenca ogni SDK e pacchetto da cui dipende questa app e a cosa serve ciascuno.»
• «Verifica se qualcuno dei nostri SDK è obsoleto o ha problemi di sicurezza noti.»

SDK in Mythex

L'agente Mythex può installare pacchetti nel sandbox del tuo progetto usando il gestore di pacchetti normale per il tuo stack, inclusi gli SDK dei fornitori — indica il pacchetto e la funzione che ti serve. Vedi Usare pacchetti npm. Mythex non offre un catalogo di integrazioni predefinite per la tua app: salvi la chiave del fornitore come segreto del progetto e chiedi all'agente di chiamare il servizio lato server, come descritto in Integrare qualsiasi API.

Per il livello sotto gli SDK, leggi cos'è un'API. Per due funzioni comuni basate su SDK, vedi come aggiungere i pagamenti alla tua app e come usare le API LLM.

Domande