PAIN-FREE APIS WITH SMITHY4S
summary
Claim: define an API once and generate everything from it. Uses Smithy as the IDL and smithy4s to generate single source of truth specs into readable, dependency‑free Scala code that compiles for JVM, Scala.js and Native. Produces server HTTP4S interpreter routes, clients, a CLI and a Swagger UI page via the built‑in simple-rest-json protocol. Works at org scale; tooling includes deprecation traits and AWS‑biased compatibility checks, so not recommended for tiny hobby projects.
AI-written summary · about
chapters (12)
- 0:00Start
- 1:231/3 Let's talk about problems
- 3:48Misunderstood requirements
- 5:09Solving the wrong problem
- 7:01Writing problems
- 7:56Documentation problems
- 9:00Maintenance problems
- 10:16Interface definition language (IDL)
- 12:05Created by AWS
- 14:28Readable for machines
- 16:59Readable for humans
- 19:24Facilitates communication
