Spezifikations‑Alternativen: Smithy und TypeSpec

Client SDKs: Die schöneren APIs?

APIs sind das Rückgrat moderner Softwareentwicklung, doch wer kennt nicht das Dilemma? Die API ändert sich, Fehlermeldungen stapeln sich im Postfach, und plötzlich hängt dein Workflow am seidenen HTTP-Thread. Genau dort kommen Client SDKs ins Spiel. Sie machen aus kryptischen API-Endpunkten handliche, sprachnahe Werkzeuge, die dir nicht nur Nerven, sondern auch Zeit sparen.

In dieser Episode schauen wir hinter die Kulissen der SDK-Entwicklung. Wir sprechen aus Maintainer-Perspektive über Supportdruck, Burnout und die (oft unterschätzte) Verantwortung in Open Source. Gleichzeitig tauchen wir tief in die Praxis ein: Was ist ein Client SDK genau? Wann lohnt sich Handarbeit, wann die Code-Generation? Warum ist idiomatisches SDK-Design mehr als nur Style – und weshalb boosten einige SDKs wie das von Stripe oder AWS sogar den wirtschaftlichen Erfolg ganzer Unternehmen?

Gemeinsam werfen wir einen Blick auf Architektur, Best Practices, Edge Cases, Testing, Dokumentation und Wartung. Und natürlich diskutieren wir, wann ein SDK wirklich sinnvoll ist – und in welchen Fällen du lieber einen simplen HTTP-Aufruf selbst schreibst.

Bonus: Wieso Atlassian Merch statt Sponsoring schickt.

Unsere aktuellen Werbepartner findest du auf https://engineeringkiosk.dev/partners

Das schnelle Feedback zur Episode:

👍 (top) 👎 (geht so)

Anregungen, Gedanken, Themen und Wünsche

Dein Feedback zählt! Erreiche uns über einen der folgenden Kanäle …

• EngKiosk Community: https://engineeringkiosk.dev/join-discord 
• LinkedIn: https://www.linkedin.com/company/engineering-kiosk/
• Email: stehtisch@engineeringkiosk.dev
• Mastodon: https://podcasts.social/@engkiosk
• Bluesky: https://bsky.app/profile/engineeringkiosk.bsky.social
• Instagram: https://www.instagram.com/engineeringkiosk/

Unterstütze den Engineering Kiosk

Wenn du uns etwas Gutes tun möchtest … Kaffee schmeckt uns immer 

• Buy us a coffee: https://engineeringkiosk.dev/kaffee

Links

• Engineering Kiosk Episode #204 Resilience Engineering: Timeouts, Jitter, Backoff & andere Systemretter: https://engineeringkiosk.dev/podcast/episode/204-resilience-engineering-timeouts-jitter-backoff-andere-systemretter/
• Go library for accessing the GitHub v3 API: https://github.com/google/go-github
• Go client library for Atlassian Jira: https://github.com/andygrunwald/go-jira
• Semantic Versioning 2.0.0: https://semver.org/
• go-github “feat: Allow blocking until primary rate limit is reset #3117”: https://github.com/google/go-github/pull/3117
• Ollama OpenAI API Kompatibilität: https://ollama.com/blog/openai-compatibility
• Smithy: https://smithy.io/
• Introducing AWS API models and publicly available resources for AWS API definitions: https://aws.amazon.com/de/blogs/aws/introducing-aws-api-models-and-publicly-available-resources-for-aws-api-definitions/
• TypeSpec: https://typespec.io/
• Engineering Kiosk Episode #214 Daten aus Spotify & Co: Architektur einer skalierbaren API-Data-Pipeline: https://engineeringkiosk.dev/podcast/episode/214-daten-aus-spotify-co-architektur-einer-skalierbaren-api-data-pipeline/
• Engineering Kiosk Episode #126 Killing the Mutant: Teststrategien mit Sebastian Bergmann: https://engineeringkiosk.dev/podcast/episode/126-killing-the-mutant-teststrategien-mit-sebastian-bergmann/
• Engineering Kiosk Episode #175 Von Lustig bis Traurig: Wenn Open Source Geschichten schreibt: https://engineeringkiosk.dev/podcast/episode/175-von-lustig-bis-traurig-wenn-open-source-geschichten-schreibt/

Sprungmarken

(00:00:00) Eine kleine Geschichte über die Entwicklung von Client SDKs

(00:04:26) Info/Werbung

(00:05:26) Eine kleine Geschichte über die Entwicklung von Client SDKs

(00:21:32) Wer schreibt SDKs? SDKs können die Produkte boosten

(00:27:16) Welche Code- und Design-Prinzipien sind für ein SDK entscheidend?

(00:39:12) Client SDKs auf Basis von Spezifikationen generieren?

(00:54:40) Testing von Client SDKs

(00:59:52) Wann macht es keinen Sinn, ein Client SDK zu nutzen?

Hosts

• Wolfgang Gassler (https://gassler.dev) 
• Andy Grunwald (https://andygrunwald.com/)

Community

Diskutiere mit uns und vielen anderen Tech-Spezialist⋅innen in unserer Engineering Kiosk Community unter https://engineeringkiosk.dev/join-discord