~/talk

Specification-Driven Development of REST APIs

Talkat apidays Helsinki 2019 · 2019-06-04..06-05· [api-design]
links:none on file
slides:none on file

Tooling shows how a compact, human syntax converts into a full OpenAPI artifact: Tiny Spec turns three terse files into a 57-line OpenAPI JSON and then reuses that OpenAPI JSON for automated unit tests, request validation via JSON Schema, and model serialization with Sequelize serialize. Examples include a patch user_update schema that drops is_admin and enforces strict properties, a type-casting step before validation, and generated TypeScript types for end-to-end consistency.

AI-written summary · about

  1. 0:00Start
  2. 0:40What Is a Specification
  3. 2:18Open Api
  4. 4:26Online Editors and Services
  5. 4:54Reuse Your Specification Code
  6. 7:47The Json Api
  7. 8:18The Unit Test
  8. 10:01Json Schema
  9. 11:23User Data Validation
  10. 12:05User Update
~/search
type to search 6,249 conferences, 138,987 speakers and 185,172 talks
~/help
cmdctrl k
search every conference, speaker and series
/
focus the filter search
h
home
c
conferences
s
speakers
e
series
t
light / dark — the status bar button does the same
?
this help
esc
close this, then clear every filter — or just the search, while you are typing in it

Ignored while you are typing. Pages without a filter rail have no search to focus.