Hvad er en SDK? Software Development Kits forklaret enkelt

En SDK (software development kit) er et færdigt værktøjssæt, som en virksomhed giver udviklere, så de kan bruge dens tjeneste eller platform uden at bygge alt fra bunden. Den indeholder typisk et kodebibliotek til et bestemt programmeringssprog, dokumentation og eksempler og somme tider ekstra værktøjer som testhjælpere. Når din app "bruger Stripe-SDK'en", betyder det, at din kode kalder Stripes færdige funktioner, i stedet for at skrive hver forespørgsel til Stripes API i hånden.

Hvorfor SDK'er betyder noget, når du bygger med AI

Når du beder en AI-app-builder om at tilføje betalinger, AI-chat, kort eller e-mail, installerer den typisk udbyderens SDK og skriver nogle få linjer, der kalder den. At vide, hvad en SDK er, hjælper dig med at:

• Forstå, hvad der tilføjes til dit projekt. En SDK er en afhængighed — ekstern kode, som din app nu er afhængig af.
• Se den opsætning, den kræver. Næsten alle SDK'er kræver en API-nøgle, og mange har separate "server"- og "browser"-versioner med forskellige regler for, hvilke nøgler der er sikre at bruge.
• Bede om det rigtige. "Brug den officielle Stripe-SDK på serveren" er en klarere instruktion end "tilføj Stripe".
• Læse fejl. Mange fejl i AI-byggede apps skyldes, at en SDK er fejlkonfigureret, forældet eller brugt det forkerte sted.

En hverdagsanalogi

Forestil dig, at du vil sætte hylder op.

• API'en er bygningens regler: hvilke vægge der kan tåle skruer, hvor meget de bærer, og hvor rørene ligger. Du kunne arbejde ud fra reglerne alene, måle og bore alt selv.
• SDK'en er et flatpack-hyldesæt fra samme firma, der byggede væggene: færdigskårne dele, de rigtige skruer, et beslag der passer præcist til deres vægge og en vejledning.

Du bestemmer stadig, hvor hylden skal hænge, og hvad der skal stå på den. Sættet sparer dig for at save træ og gætte skruestørrelser — og det er mindre sandsynligt, at du ender med et hul i et vandrør.

SDK vs. API vs. bibliotek vs. framework

Disse begreber overlapper, og det forvirrer mange:

En SDK indeholder typisk et bibliotek, og det bibliotek kalder typisk en API. For en webtjeneste bruges "SDK" og "klientbibliotek" ofte om hinanden.

Som nogle SDK'er slet ikke handler om webtjenester. Apple og Google udgiver SDK'er til at bygge iOS- og Android-apps, med compilere, simulatorer og platformskode. Ideen er den samme: alt, hvad du behøver for at bygge til deres platform, i ét sæt.

Hvad en SDK gør for dig

Her er den samme opgave — oprettelse af en kunde hos en betalingsudbyder — gjort på to måder.

Uden SDK skal din kode selv bygge HTTP-forespørgslen: sætte URL'en, lægge den hemmelige nøgle i den rigtige header, formatere data, som API'en forventer, sende den, tjekke statuskoden, læse svaret og håndtere genforsøg, hvis netværket svigter.

Med SDK bliver det tættere på én linje:

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

Bag den linje håndterer SDK'en:

• Login — den hænger din nøgle korrekt på hver forespørgsel
• Dataformatering — den omsætter dine data til det, API'en forventer, og svaret tilbage til objekter
• Fejl — den omsætter statuskoder til tydelige fejltyper, din kode kan fange
• Genforsøg — den prøver sikkert igen, når en forespørgsel fejler af midlertidige grunde (mange officielle SDK'er gør dette)
• Typer — i TypeScript fortæller den din editor, hvilke felter der findes, så fejl vises, før du kører koden

Et konkret eksempel: AI-svar i en supportapp

Du beder en AI-app-builder: "Når en kunde sender en supportsag, så generer et foreslået svar med en AI-model."

1. AI'en installerer modeludbyderens officielle SDK som en pakke i dit projekt (i JavaScript-projekter fra npm-registret).
2. Du tilføjer udbyderens API-nøgle som en projekthemmelighed. SDK'en læser den fra en miljøvariabel på serveren.
3. AI'en skriver en serverrute, der kalder SDK'en med sagens tekst og en kort instruks, og gemmer det foreslåede svar i databasen.
4. Browseren ser aldrig nøglen; den kalder kun din egen serverrute.

Hvis udbyderen senere ændrer sin API, udgiver den typisk en ny SDK-version. At opdatere pakken — og tjekke releasenoterne for brydende ændringer — er ofte alt, der skal til.

Vigtige begreber

Almindelige misforståelser

• "En SDK og en API er det samme." API'en er tjenestens grænseflade; SDK'en er et bekvemmelighedslag oven på. De fleste webtjenester kan kaldes uden SDK — det er bare mere arbejde.
• "Hvis SDK'en er installeret, er integrationen færdig." Du skal stadig have en konto hos udbyderen, de rigtige nøgler og kode, der håndterer det, der sker, når noget fejler.
• "Enhver pakke med det rigtige navn er den officielle." Angribere udgiver nogle gange look-alike-pakker. Tjek udbyderens dokumentation for det præcise pakkenavn.
• "Browser-SDK'en kan bruge min hemmelige nøgle." Aldrig. Alt i browserkode er synligt for besøgende. Hemmelige nøgler hører kun til i server-side kode — se sådan holder du API-nøgler sikre.
• "SDK'er behøver aldrig opdateres." Gamle versioner får ikke rettelser mere og holder op med at virke, når udbydere udfaser gamle API-versioner.

Hvad du spørger din AI-builder om

• "Brug udbyderens officielle SDK, ikke en tredjepartsindpakning. Fortæl mig det præcise pakkenavn og den version, du installerede."
• "Brug kun SDK'en på serveren, og læs nøglen fra en miljøvariabel."
• "Hvilke dele af denne SDK kører i browseren, og hvilke nøgler bruger de?"
• "Hvad sker der, hvis SDK-kaldet fejler eller timer ud? Vis brugeren en tydelig besked, og log fejlen."
• "List alle SDK'er og pakker, denne app er afhængig af, og hvad hver af dem bruges til."
• "Tjek, om nogle af vores SDK'er er forældede eller har kendte sikkerhedsproblemer."

SDK'er i Mythex

Den Mythex-agent kan installere pakker i dit projekts sandbox med den normale pakkehåndtering for din stak, herunder udbyderes SDK'er — nævn pakken og den funktion, du vil bruge den til. Se Brug npm-pakker. Mythex leverer ikke et katalog med færdige integrationer til din app: du gemmer udbyderens nøgle som projekthemmelighed og beder agenten kalde tjenesten fra serversiden, som beskrevet i Integrer enhver API.

Til laget under SDK'er, læs hvad er en API. For to almindelige SDK-baserede funktioner, se sådan tilføjer du betalinger til din app og sådan bruger du LLM-API'er.

Spørgsmål