Què és un SDK? Kits de desenvolupament de programari explicats fàcilment

Un SDK (software development kit) és un conjunt d'eines preparat que una empresa ofereix als desenvolupadors perquè puguin fer servir el seu servei o plataforma sense construir-ho tot de zero. Normalment inclou una biblioteca de codi per a un llenguatge de programació concret, documentació i exemples, i de vegades eines addicionals com utilitats de prova. Quan la teva aplicació «fa servir el SDK de Stripe», vol dir que el teu codi crida les funcions preconstruïdes de Stripe en lloc d'escriure a mà cada petició a la seva API.

Per què importen els SDK quan construeixes amb IA

Quan demanes a un constructor amb IA que afegeixi pagaments, un xat d'IA, mapes o correu electrònic, normalment instal·larà el SDK d'aquell proveïdor i escriurà unes quantes línies que el criden. Saber què és un SDK t'ajuda a:

• Entendre què s'afegeix al teu projecte. Un SDK és una dependència: codi extern del qual la teva aplicació depèn ara.
• Detectar la configuració que necessita. Gairebé tots els SDK necessiten una clau d'API, i molts tenen versions separades per al «servidor» i per al «navegador», amb regles diferents sobre quines claus es poden fer servir amb seguretat.
• Demanar la cosa correcta. «Fes servir el SDK oficial de Stripe al servidor» és una instrucció més clara que «afegeix Stripe».
• Llegir errors. Molts errors en aplicacions construïdes amb IA es deuen a un SDK mal configurat, desactualitzat o usat en el lloc equivocat.

Una analogia del dia a dia

Imagina que vols penjar unes prestatgeries.

• La API són les normes de l'edifici: quines parets aguanten tacs, quina càrrega suporten, on hi ha les canonades. Podries treballar només amb aquestes normes, mesurant i foradant-ho tot tu mateix.
• El SDK és un kit de prestatgeria en caixa plana de la mateixa empresa que va fer les parets: peces ja tallades, els cargols adequats, un suport que encaixa exactament amb les seves parets i un manual d'instruccions.

Tu continues decidint on va la prestatgeria i què hi posa. El kit només t'estalvia tallar la fusta i endevinar les mides dels cargols, i és menys probable que acabis fent un forat en una canonada.

SDK vs API vs biblioteca vs framework

Aquests termes es barregen i confonen molta gent:

Un SDK normalment conté una biblioteca, i aquesta biblioteca normalment crida una API. Per a un servei web, «SDK» i «biblioteca client» sovint s'usen indistintament.

Alguns SDK no tenen res a veure amb serveis web. Apple i Google publiquen SDK per construir aplicacions per a iOS i Android, que inclouen compiladors, simuladors i codi de la plataforma. La idea és la mateixa: tot el que necessites per construir per a la seva plataforma, en un sol kit.

Què fa un SDK per tu

Aquí teniu la mateixa tasca —crear un client en un proveïdor de pagaments— feta de dues maneres.

Sense SDK, el teu codi ha de construir la petició HTTP per si mateix: establir la URL, afegir la clau secreta a la capçalera correcta, formatar les dades com les espera l'API, enviar-les, comprovar el codi d'estat, analitzar la resposta i gestionar els reintents si la xarxa falla.

Amb SDK, és més proper a una sola línia:

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

Darrere d'aquesta línia, el SDK gestiona:

• Autenticació: adjuntar la teva clau correctament a cada petició
• Format de dades: convertir les teves dades al format que espera l'API, i la resposta de nou en objectes
• Errors: convertir els codis d'estat en tipus d'error clars que el teu codi pot capturar
• Reintents: tornar a provar de manera segura quan una petició falla per motius temporals (molts SDK oficials ho fan)
• Tipus: en TypeScript, indicar a l'editor quins camps existeixen, perquè els errors apareguin abans d'executar el codi

Un exemple pas a pas: afegir respostes d'IA a una aplicació de suport

Demanes a un constructor amb IA: «Quan un client envii un tiquet de suport, genera una resposta suggerida amb un model d'IA».

1. La IA instal·la el SDK oficial del proveïdor del model com a paquet del projecte (en projectes JavaScript, des del registre npm).
2. Tu afegeixes la clau d'API del proveïdor com a secret del projecte. El SDK la llegeix d'una variable d'entorn al servidor.
3. La IA escriu una ruta de servidor que crida el SDK amb el text del tiquet i una instrucció curta, i desa la resposta suggerida a la base de dades.
4. El navegador mai veu la clau; només crida la teva pròpia ruta de servidor.

Si el proveïdor canvia més endavant la seva API, normalment publica una nova versió del SDK. Actualitzar el paquet —i revisar les notes de la versió per veure els canvis que trenquen compatibilitat— sol ser tot el que cal.

Termes clau

Idees errònies habituals

• «Un SDK i una API són el mateix». L'API és la interfície del servei; el SDK és una capa de comoditat a sobre. Pots cridar la majoria d'API web sense SDK; només és més feina.
• «Si el SDK està instal·lat, la integració ja està feta». Encara necessites un compte amb el proveïdor, les claus adequades i codi que gestioni el que passa quan les coses fallen.
• «Qualsevol paquet amb el nom correcte és l'oficial». De vegades els atacants publiquen paquets que s'hi assemblen. Revisa la documentació del proveïdor per al nom exacte del paquet.
• «El SDK del navegador pot fer servir la meva clau secreta». Mai. Tot el que hi ha al codi del navegador és visible per als visitants. Les claus secretes només pertanyen al codi del servidor; consulta com mantenir segures les claus d'API.
• «Els SDK mai necessiten actualitzar-se». Les versions antigues deixen de rebre correccions i acaben deixant de funcionar quan els proveïdors retiren les versions antigues de l'API.

Què preguntar al teu constructor d'IA

• «Fes servir el SDK oficial del proveïdor, no un embolcall de tercers. Digues-me el nom exacte del paquet i la versió que has instal·lat.»
• «Fes servir el SDK només al servidor i llegeix la clau d'una variable d'entorn.»
• «Quines parts d'aquest SDK s'executen al navegador i quines claus fan servir?»
• «Què passa si la crida al SDK falla o caduca? Mostra a l'usuari un missatge clar i registra l'error.»
• «Llista cada SDK i paquet del qual depèn aquesta aplicació i per a què serveix cadascun.»
• «Comprova si algun dels nostres SDK està desactualitzat o té problemes de seguretat coneguts.»

Els SDK a Mythex

L'agent de Mythex pot instal·lar paquets al sandbox del projecte fent servir el gestor de paquets normal del teu stack, incloent-hi els SDK dels proveïdors: digues el paquet i la funcionalitat per a la qual el vols. Consulta Fer servir paquets npm. Mythex no ofereix un catàleg d'integracions preconstruïdes per a la teva aplicació: desa la clau del proveïdor com a secret del projecte i demana a l'agent que cridi el servei des del servidor, tal com es descriu a Integrar qualsevol API.

Per a la capa que hi ha sota dels SDK, llegeix què és una API. Per a dues funcionalitats habituals basades en SDK, consulta com afegir pagaments a la teva aplicació i com fer servir les API de LLM.

Preguntes