Real-World Enterprise REST API Design
summary
Swiss Post engineers adopt contract-first REST design with a swagger-based toolchain (open source Iana) that uses TypeScript model files, npm and Maven packaging, and code generation to Java. The demo builds a reusable types package, publishes it to Maven/npm, imports it into a petstore API, and generates Swagger UI docs, Jackson JSON bindings and Java validation annotations so consumers and providers link to exact versions. Sequence diagrams and a JIRA-linked review workflow enforce consistent domain models across many microservices.
AI-written summary · about
chapters (6)
- 0:00Introduction
- 2:41Documentation
- 4:43Swagger
- 5:46Dependency Management
- 6:17Code Generation
- 12:58API Economy
related talks
21mReal-World Enterprise REST API Design
33mDocumenting REST APIs with Swagger
43mAPI first with Swagger and Scala
01h 23mDocumenting RESTful APIs
01h 39mLet’s have some Effective REST
01h 34mDesigning a REST-ful API using Spring 3
46mLet’s have some effective REST!
51mREST beyond the obvious – API design for ever evolving systems