Gateway RidgeISSUE #27 of 35

sdks · generated vs hand-written

Gateway GusVSTimeout Titan

Gateway Gus saysSDKs wrap an API in a language-native client — generated from a spec or hand-written.

An SDK (software development kit) gives developers a friendly, typed client (client.users.get(42)) instead of raw HTTP. Generated SDKs (from OpenAPI) stay in sync with the API and cover many languages cheaply; hand-written ones offer better ergonomics and docs but cost maintenance. Good SDKs handle auth, retries, and pagination so each consumer doesn't reinvent them.

Power-ups you unlock

Native typed client over raw HTTP
Generated (from spec) vs hand-written
SDKs handle auth, retries, pagination
Generated scales; hand-written feels better

Timeout Titan attacks — common mistakes

Generated SDKs with poor ergonomics shipped as-is
Hand-written SDKs that drift from the API
Each consumer reimplementing retries/pagination

Boss battleWeigh generated vs hand-written SDKs for a 12-language API.

Example code

<!doctype html><html><head><meta charset="utf-8"></head>
<body style="background:#06040d;color:#e6e0ff;font-family:monospace;padding:20px"><pre>raw:  fetch('/users/42', { headers:{Authorization:...} })
SDK:  client.users.get(42)   // auth + retries built in</pre></body></html>

▶ Open the interactive comic issue

‹ Asyncapi · Spec For Event-Driven Api Design · Resources First · Then Verbs ›