SDK (Software Development Kit)

Un SDK (Software Development Kit) è un pacchetto pronto all'uso di librerie di codice, strumenti e documentazione che trasforma un'API in funzioni per un linguaggio di programmazione. Invece di scrivere richieste HTTP grezze, gli sviluppatori richiamano funzioni già pronte.

Che cos'è un SDK?

Un SDK (Software Development Kit) è un pacchetto pronto all'uso di librerie di codice, strumenti e documentazione per un linguaggio di programmazione. Trasforma un'API in funzioni che gli sviluppatori richiamano direttamente. Invece di costruire a mano le richieste HTTP, leggere le risposte JSON e gestire da sé gli errori, basta una riga come client.messages.send(). Al resto pensa l'SDK.

Esistono due varianti. Un SDK leggero rispecchia gli endpoint dell'API uno a uno e aggiunge soprattutto i tipi. Un SDK completo offre comodità in più, come nuovi tentativi automatici, paginazione o la verifica delle firme dei webhook. Ogni SDK è legato a un solo linguaggio: un fornitore che vuole servire sviluppatori Python, JavaScript e PHP deve creare e mantenere tre pacchetti separati.

SDK o REST API diretta?

Un SDK è sempre uno strato sopra un'API, di solito una REST API. Entrambe le strade portano allo stesso risultato. La differenza sta nell'impegno:

• Con un SDK: avvio più rapido, funzioni tipizzate e meno errori nel codice. In cambio dipendi dal fornitore, che deve tenere aggiornato il pacchetto per il tuo linguaggio e la tua versione.
• Direttamente via REST: funziona con qualsiasi linguaggio in grado di inviare richieste HTTP, senza pacchetti aggiuntivi. Vedi esattamente cosa viene trasmesso, ma autenticazione, gestione degli errori e nuovi tentativi li scrivi tu.

Per la maggior parte delle integrazioni di messaggistica bastano poche chiamate REST dirette: autenticarsi, inviare un messaggio, ricevere gli aggiornamenti di stato. Per questo molti team rinunciano del tutto agli SDK oppure generano un proprio client a partire dalla descrizione dell'API.

Il tuo client da una specifica OpenAPI

Molte API pubblicano una specifica OpenAPI: un file leggibile dalle macchine che descrive ogni endpoint, ogni parametro e ogni risposta. Da questo file ottieni gran parte di ciò che offre un SDK, senza aspettare un pacchetto ufficiale:

• Generare codice client: strumenti come OpenAPI Generator creano dalla specifica un client tipizzato per il tuo linguaggio.
• Testare negli strumenti API: Postman, Insomnia o Bruno importano la specifica, così provi ogni endpoint prima di scrivere codice.
• Usare strumenti di programmazione con IA: assistenti come Claude Code, Cursor o GitHub Copilot leggono specifica e documentazione e scrivono il codice di integrazione per il tuo stack.

SDK e SendSeven

SendSeven non offre SDK per i singoli linguaggi per la sua REST API. L'unico SDK è il Push SDK: un piccolo frammento di codice che aggiunge le notifiche push del browser al tuo sito web. Per tutto il resto ti colleghi direttamente alla REST API, con questi aiuti:

• Specifica OpenAPI: per generare codice client o importarla in Insomnia o Bruno.
• Collection Postman: richieste pronte per provare gli endpoint.
• Documentazione per strumenti di programmazione con IA: ogni pagina di docs.sendseven.com è disponibile anche in Markdown, insieme a un prompt pronto per Claude Code, Cursor e GitHub Copilot.
• Server MCP: gli agenti IA come Claude lavorano direttamente con SendSeven.
• Senza codice: Zapier, Make e n8n collegano SendSeven ad altri strumenti senza programmare.

L'autenticazione avviene con una chiave API inviata come token Bearer. Le istruzioni passo passo sono nella guida all'autenticazione API, tutti gli endpoint nella documentazione per sviluppatori.