~/talk

REST - The ignored parts

Talkat NDC London 2021 · 2021-01-25..01-29· [web-platform, api-design]
slides:none on file

Claim: most APIs calling themselves REST are just JSON over HTTP because teams ignore HTTP's constraints like HATEOAS and proper versioning. Demo uses .NET Core + Entity Framework + SQL Server and Postman to show concrete fixes: enable content negotiation and XML formatter, use HEAD/OPTIONS, return 201 with Location, configure automatic validation (validation problem details / application/problem+json / 422), and use API versioning via header or query instead of version-in-path. Toolbox shown: jsonapi.netcore, ASP.NET Core API versioning and ConfigureApiBehavior; some demos ran and produced 201/406/200 as expected while a few live-demo hiccups occurred. HATEOAS ignored

AI-written summary · about

  1. 0:00Start
  2. 1:15Agenda
  3. 1:34What Is Rest Representational State Transfer
  4. 4:35Caching
  5. 5:11The Uniform Interface
  6. 6:05Client Server
  7. 7:34The Caching
  8. 11:17Identify Resources
  9. 15:03Self-Descriptive Messages
  10. 15:37Media Types
  11. 17:03Endpoints
  12. 20:45Status Codes
  13. 26:58Describe Errors
  14. 41:09Browser Accept Header
  15. 54:48Versioning
  16. 55:54Default Api Version
  17. 56:47Api Versioning Error Provider
~/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.