Create delightful SDKs from OpenAPI
summary
Generates a Go SDK for the Vonage Verify API using openapi-generator.tech inside Docker, producing client code and strongly typed models but leaving machine‑written output described as “better than nothing.” A thin handmade jam layer adds auth helpers (including a JWT helper and signature one-liner verifier), a JSON builder for call control objects, and clear examples. The workflow regenerates the machine code from updated OpenAPI specs and keeps only the user‑facing wrappers hand‑maintained so the SDK stays accurate and maintainable.
AI-written summary · about
chapters (16)
- 0:00Introduction
- 2:27What is OpenAPI
- 3:48Why describe your APIs
- 6:12Why generate SDKs
- 6:24Documentation
- 7:42OpenAPI Generator
- 9:34Generated Code
- 10:59Thoughts on Generated Code
- 12:23OpenAPI Documentation
- 12:54The Jam
- 14:29Wrap the sharp edges
- 14:54User interface example
- 15:24Helpers
- 17:15Security helpers
- 20:51What makes SDKs delightful
- 23:17Questions
related talks
33mHow to build an SDK in Go
30mDeploying and building SDKs as a service Developer
26mOpenAPI Generator - The Babel Fish of the API World
35mAPI-First! Contract-First! Make API development great again!
01mWelcome to – Daniel Kosasih
30mArtisanal, machine-generated API libraries
18mSimplifying Consuming APIs for SDK Haters
24mBuilding Mobile SDKs for iOS and Android