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.