~/talk

tfl.fyi: Building Human-consumable APIs

Talkat HalfStack Vienna 2023 · on Friday, 2023-09-15· [api-design, web-platform]
links:none on file
slides:none on file

A prototype called tfl.fyi fetches TfL’s unified API every 30 seconds into Node.js worker threads, pre‑processes responses into tiny request objects and serves a single HTTP payload so users underground get status with one single HTTP request. It handles fuzzy free‑text stop searches, hides messy natpan/ICS IDs, and avoids dozens of concurrent calls that kill low‑bandwidth connections. The service proves the approach is viable though it has occasional outages; major takeaways: version APIs, timestamp UIDs, and provide dummy data.

AI-written summary · about

  1. 0:00Introduction and welcome
  2. 2:29How TfL’s transport system works
  3. 8:28Challenges with TfL’s API
  4. 12:58Real-world complexities of transport data
  5. 16:49Problems with inconsistent API payloads
  6. 17:52Introducing tfl.fyi project
  7. 18:13Architecture of tfl.fyi
  8. 20:41Designing the API surface
  9. 22:06Lessons learned from TfL’s API
  10. 23:29Building APIs for human users
  11. 23:50Closing and call to action
~/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.