Was ist ein SDK? SDK vs. Bibliothek vs. Framework vs. API

Ein SDK (Software Development Kit) bündelt eine Fähigkeit zusammen mit allem, was man zum Einsatz braucht: eine oder mehrere APIs, Laufzeitabhängigkeiten, Konfiguration und Zugangsdaten, Dokumentation und Beispiele, manchmal ein Kommandozeilenwerkzeug. Ob ein Paket ein SDK ist, entscheidet nicht die Menge an Code, sondern ob es die Arbeit drumherum — Authentifizierung, Fehlerbehandlung, Werkzeuge — mitliefert. Der Unterschied ist im Alltag konkret. Eine Bibliothek löst „du warst es leid, diese Logik zu schreiben, nimm meine". Ein SDK löst „du musst diese externe Fähigkeit anbinden, und ich habe von der Authentifizierung bis zur Fehlerbehandlung alles durchdacht".

Die vier Begriffe auseinanderhalten

Dimension API Bibliothek Framework SDK
Wer ruft wen Du sendest Anfragen Du rufst sie auf Es ruft dich auf Du rufst es auf, und es bringt Werkzeuge mit
Form Schnittstellenvertrag (HTTP oder Funktionssignatur) Wiederverwendbarer Code Gerüst plus Konventionen und Lebenszyklus Paket plus Doku, Konfiguration und Beispiele, evtl. CLI
Kontrolle Vollständig bei dir Vollständig bei dir Das Framework bestimmt den Ablauf Bei dir — ein SDK übernimmt nicht deine App-Struktur
Typisches Beispiel REST-Endpunkte, GraphQL Datumsverarbeitung, Diagramme Frontend- oder Backend-Framework Cloud-SDK, Payment-SDK, Feedback-SDK
Was du noch tun musst Alles Zusammensetzen und aufrufen Fachlogik in den Konventionen füllen Zugangsdaten beantragen, nach Doku initialisieren
Merksatz: Eine API ist ein Vertrag, eine Bibliothek ein Bauteil, ein Framework ein Gerüst, ein SDK das Bauteil plus Anleitung plus Anschlussplan.

Was in einem SDK steckt

Bestandteil Zweck Was ohne ihn kaputtgeht
API-Wrapper Verwandelt HTTP-Details, Retries und Fehlercodes in Funktionen Jeder Integrator schreibt es neu, mit anderem Verhalten
Laufzeit und Abhängigkeiten Sorgt dafür, dass es in der Zielumgebung läuft (Browser, Node-Server) Versionskonflikte, ausufernde Bundle-Größe
Konfiguration und Zugangsdaten Keys, Region, Umgebung, Schalter Fest verdrahtete Secrets, Test und Produktion vermischt
Doku und Beispiele Bringt jemanden in zehn Minuten zum ersten funktionierenden Aufruf Integration hängt an Rückfragen, die Supportkosten landen bei dir
Werkzeuge (optional) CLI, Debug-Panel, Typdefinitionen Fehlersuche wird zum Raten
Die letzte Zeile gilt oft als Bonus. Tatsächlich entscheidet sie über den Ruf eines SDK: SDKs mit vollständigen Typdefinitionen und Debug-Werkzeugen erzeugen deutlich weniger Nacharbeit bei den Integratoren.

Drei Vertriebswege, drei Kostenprofile

Weg Wie die Version festgelegt wird Wer aktualisiert Hauptkosten
Paketmanager (npm und ähnliche) Lockfile pinnt eine Version Der Integrator, bewusst Braucht eine Build-Pipeline; alte Versionen leben jahrelang
Script-Tag (CDN) Über URL oder Konfiguration Der Anbieter CSP muss die Domain erlauben; Caching muss geplant werden
In eine Plattform eingebaut Folgt der Plattformversion Die Plattform Du kontrollierst den Rhythmus praktisch nicht
Das Script-Tag passt zu allem, was „auch Besucher nutzen müssen": keine Installation, kein Build, eine Zeile einfügen und es läuft. Der Preis: Versionkompatibilität und CSP-Allowlist liegen bei dir. Deshalb wählen viele Feedback- und Support-SDKs diesen Weg.

Die versteckten Kosten eines eigenen SDK

Ein Feature als SDK zu verpacken ist leicht. Fünf Jahre damit zu leben nicht:
  • Abwärtskompatibilität: Funktionsnamen, Parameter und Callback-Zeitpunkte lassen sich nach der Veröffentlichung nicht frei ändern. Eine Änderung, und alle Integratoren müssen nachziehen.
  • Größe und Performance: Das SDK läuft auf fremden Seiten. 100KB mehr können deren First-Paint-Werte verschieben.
  • Datenschutz und Compliance: Was erhoben wird, wie lange es bleibt und ob man es abschalten kann, muss dokumentiert und tatsächlich wahr sein — unsere Grenzen stehen in der Datenschutzerklärung.
  • Beobachtbarkeit: Wenn das SDK selbst kaputt ist, sagen Integratoren nur „euer Ding ist kaputt". Du brauchst eigene Fehlerberichte und Versionsverteilung.
  • Doku und Beispiele: Ein SDK ohne Dokumentation ist kein SDK; die Kosten kommen als Support-Tickets zurück.
  • Von diesen fünf sind die ersten drei die klassischen „vor dem Launch unsichtbar, danach unvermeidbar".

    Wie ein Feedback-SDK aussieht

    Das Web SDK von BugCapturer braucht zwei Schritte: im Konsolenbereich ein Projekt anlegen und eine Domain-Allowlist setzen, dann das Skript auf die Seite legen.
    html
    <script>window.BugCapturerConfig={key:"bcpk_xxxxxxxx",position:"bottom-right",requireContact:false}</script>
    <script src="https://api.bugcapturer.com/sdk/bugcapturer.js" async></script>
    
    Die Konfiguration ist klein, und jede Option hat eine klare Grenze:
    Option Zweck Worauf achten
    key Projektkennung Bewusst öffentlich; Zugriff begrenzt die Domain-Allowlist
    position Position des schwebenden Einstiegs Nicht Checkout- oder Support-Buttons verdecken
    requireContact Ob Besucher Kontaktdaten hinterlassen müssen Auf öffentlichen Seiten abschalten, sonst sinkt die Meldequote
    reporter Identität der meldenden Person, von der Seite übergeben Nie eine Person fest verdrahten; aus der Session füllen
    Die Besuchererfahrung sollte man präzise beschreiben: Besucher mit installierter Erweiterung übergeben die Erfassung an diese, ganz ohne Berechtigungsdialog; ohne Erweiterung erscheint pro Bericht eine Browser-Berechtigung, danach wird der Screenshot erstellt. Das ist das Sicherheitsmodell des Browsers, keine Bequemlichkeit — jedes Web-SDK, das „völlig unsichtbare Screenshots" verspricht, verdient eine Rückfrage, wie es das macht. Die vollständige Anleitung steht im Web-SDK-Schnellstart; dieser Artikel wiederholt sie nicht.

    Ein SDK ist keine Browser-Erweiterung

    Beides wird oft „Integrationsweg" genannt, die Grenzen sind aber verschieden:
    Dimension SDK Browser-Erweiterung
    Wer installiert Die Seite, im Code Jede Person selbst
    Wen erreicht es Alle Besucher Nur Installierende
    Quelle der Berechtigung Domain-Allowlist plus Zustimmung pro Bericht Von der Erweiterung deklarierte Rechte
    Passt zu Kundenfeedback einsammeln Interne Tests und Walkthroughs
    Hauptgrenze Erfordert Codeänderungen an der Seite Kunden installieren keine Erweiterung für eine Website
    „Kunden sollen melden können" ist also im Kern ein SDK- oder Share-Link-Problem; die Erweiterung ist für intern. Der Vergleich steht in Chrome-Erweiterung vs. Desktop-Tools.

    Versionsnummern lesen

    Versionierung ist wichtiger als bei einer normalen Bibliothek, weil die Aktualisierung nicht von dir abhängt:
    • Major: inkompatible Änderungen; Integratoren müssen Code anpassen.
    • Minor: neue Funktionen, abwärtskompatibel; meist unbedenklich.
    • Patch: Fehlerbehebungen; geringstes Risiko.
    Beim Script-Tag steht die Version in der URL. Anbieter sollten zwei Modi anbieten: gepinnt (der Integrator entscheidet) und automatisch (immer aktuell). Gepinnt ist stabil, automatisch bequem — aber nur, wenn du sicher bist, dass ein Update keine fremde Seite bricht. Genau daraus entstehen viele SDK-Vorfälle.

    Fünf Fragen vor jeder SDK-Integration

    Frage Warum sie wichtig ist Wie eine gute Antwort aussieht
    Welche Rechte will es? Skripte und Erweiterungen können Seiteninhalte lesen Minimaler Umfang, jedes Recht erklärt, abschaltbar
    Welche Daten erhebt es? Compliance und Kundenvertrauen Klare Liste, sensible Felder maskiert, Aufbewahrungsfrist
    Kann ein Ausfall die Seite mitreißen? Fehler von Drittanbieter-Skripten kaskadieren Timeouts blockieren den Hauptfluss nicht, Fehler isoliert
    Größe und Ladezeitpunkt? Direkter Einfluss auf First-Paint Asynchrones Laden, Lazy-Init, veröffentlichte Größe
    Wie kommen wir wieder raus? Migrationskosten werden unterschätzt Datenexport, Entfernen in einer Zeile, keine Reste
    Frage zwei und fünf werden am häufigsten übersprungen — und werden ein halbes Jahr später zum Problem.

    Selber bauen oder kaufen

    Deine Situation Empfehlung
    Die Fähigkeit ist dein Kerngeschäft (du bist das Payment-Unternehmen) Selbst bauen; das SDK ist das Produkt
    Du brauchst nur einen Einstieg und hast niemanden für die Pflege Kaufen oder übernehmen und die Zeit ins Geschäft stecken
    Compliance verlangt, dass Daten im Netz bleiben Selbst bauen oder selbst betreiben, nachdem die Wartung kalkuliert ist
    Weniger als fünf Entwickler und keine Frontend-Infrastruktur Mit einem Script-Tag starten, kein eigenes Packaging bauen
    Der einzige sinnvolle Test: Frisst diese Fähigkeit dauerhaft deine Roadmap? Wenn ja, selbst bauen. Wenn nein, keine langfristige Verbindlichkeit eingehen, nur um Kontrolle zu fühlen.

    Drei häufige Missverständnisse

    • Eine API SDK nennen: Endpunkt-Doku ohne Wrapper, Beispiele und Konfiguration ist eine API.
    • Ein SDK als Framework behandeln: Ein SDK sollte deine App-Struktur nicht übernehmen. Wenn es deine Ordnerstruktur vorschreibt, ist es ein Framework.
    • Viel hilft viel: Ein SDK, das alles macht, bedeutet meist großes Bundle, viele Rechte und riskante Upgrades. Importiere, was du brauchst.

    FAQ

    Wie hängen SDK und API zusammen? Ein SDK enthält meist einen Wrapper um eine API. Die API ist der Vertrag, das SDK dessen Umsetzung mit Werkzeugen und Doku. SDK versus Bibliothek in einem Satz? Eine Bibliothek ist Code, den du aufrufst. Ein SDK ist alles, was du zum Anbinden einer Fähigkeit brauchst — inklusive Bibliothek, Konfiguration, Doku und Werkzeugen. Ist ein Frontend-Script-Tag ein SDK? Ja. Der Vertriebsweg entscheidet nicht, ob es ein SDK ist, sondern nur, wie Versionen und Update-Verantwortung verteilt sind. Beeinflusst ein SDK die Seitenperformance? Ja, abhängig von Größe und Ladezeitpunkt. Asynchron laden und bei Bedarf initialisieren ist üblich; die Größe sollte der Anbieter veröffentlichen. Muss ich meine Build-Konfiguration ändern? Beim Script-Tag nicht — deshalb passt es zu öffentlichen Seiten. Ein Paketmanager schon, dafür mit Versions-Pinning und Typhinweisen.