Skip to content
PodSubs
ShowsPeopleGuestsJobsNewsEvents
More
BlogPodCred
Menu
ShowsPeopleGuestsJobsNewsEventsBlogPodCredNetworksSign in
Join nowSign in
  • Shows
  • People
  • Jobs
  • News
  • More
    • Guests
    • Events
    • Blog
    • PodCred
    • Networks
    Join nowSign in

Fallthrough

Fallthrough artwork

An Exploration of APIs, Versioning, & HTTP

Mar 10, 20251 hr 16 minAudio
ShareXLinkedInFacebookWhatsAppEmail

There are Web APIs everywhere, from the classic REST/HTTP, to GraphQL, to gRPC, we rely on them to get things done each and every day. But how much do we think about the design of these APIs? How do you document an API once you've created it? What even is versioning? Do we really understand HTTP? In this episode, Kris and the panel are joined by Jamie Tanna to discuss APIs, their design, how to document them, and more. Want to hear us discuss APIs and how we design identifiers? Become a supporter and enjoy bonus content and higher quality audio today, and additional perks and benefits when we add them in the future. Thanks for tuning in and happy listening! Notes: Web API Versioning Is Insufficient (08:38) http.cat (50:03) Please Stop Saying "just" (01:12:01) jvt.me/elsewhere (01:13:17) Table of Contents: Intro (00:00) Preface (01:13) Introducing Jamie Tanna (01:13) Prologue - APIs: The Leaky Kitchen Sink of Software (02:12) This chapter is supporter only content. Subscribe at https://fallthrough.fm/subscribe! Chapter 1 - Versioning & Breaking Changes (02:15) What is a breaking change? (02:17) Communicating breaking changes (05:17) APIs as Contracts (08:32) Chapter 2 - API: Annoying Perpetual Interface (08:32) APIs require planning (16:52) Chapter 3 - Documenting Designs (21:34) Can OpenAPI save us? (21:34) Design through documentation (30:40) Innovation & API/Transport Separation (34:21) Interlude - Version 0 Forever! (44:00) Chapter 4 - An Exploration of HTTP (44:26) HTTP and it's Status Codes (44:26) Chapter 5 - Identifying Identifiers (57:42) How to choose identifiers (57:42) Appendix UNPOP - Unpopular Opinions (58:01) Dylan's Unpop (58:46) Jamie's Unpop (01:01:51) Matt's Unpop (01:07:35) Ian's Unpop (01:09:17) Kris' Unpop (01:10:47) Just stop using just (01:12:01) Epilogue (01:13:13) Where to find Jamie (01:13:13) Outro (01:13:27) Hosts Kris Brandow - Host Ian Wester-Lopshire - Host Dylan Bourque - Host Matthew Sanabria - Host Jamie Tanna - Guest Socials: Website Bluesky Threads X/Twitter LinkedIn Instagram (00:00) - Intro (01:13) - Prologue (02:12) - Preface - APIs: The Leaky Kitchen Sink of Software (supporter only) (02:15) - Chapter 1 - Versioning & Breaking Changes (08:32) - Chapter 2 - API: Annoying Perpetual Interface (21:34) - Chapter 3 - Documenting Designs (44:26) - Chapter 4 - An Exploration of HTTP (57:42) - Chapter 5 - Identifying Identifiers (supporter only) (58:01) - Appendix UNPOP - Unpopular Opinions (01:13:13) - Epilogue (01:13:27) - Outro

Audio and video play straight from the show's own hosting. PodSubs stores and serves no media.

Hosts and Guests

Hosts

  • Dylan Bourque Host Feed-stated
  • Ian Wester-Lopshire Host Feed-stated
  • Kris Brandow Host Feed-stated
  • Matthew Sanabria Host Feed-stated

Guests

  • Jamie Tanna Guest Feed-stated

Credit the people on this episode

Be the first to rate this episode

More episodes

All episodes
  1. Don't Mess with C++

    Nov 14, 20261 hr 17 minAudio

    We've got another duo episode, but to continue the trend it's not with Matt! This week Steve joins Kris to talk about the drama around C++26 and its failed final vote, what a blue Texas could mean for tech, and how...

    Credit the people on this episode

  2. The Good, the Bad, and the Sloppy

    Nov 7, 202656 minAudio

    We all love a duo episode, but this week's duo isn't Kris and Matt, it's Kris and Nick! Yes, after joining us last week as a guest, Nick Gerace of East River Source Control is back to join Kris. The two dig into the...

    Credit the people on this episode

  3. A Change Is Gonna Come

    Oct 31, 20261 hr 7 minAudio

    We've got Nick Gerace back! Last time he was on he was at System Initiative, but now he's joined our very own Steve Klabnik at East River Source Control! Kris and Matt catch up with Nick on the move from one startup to...

    Credit the people on this episode

  4. The Tortoise and the Agent

    Oct 24, 20261 hr 12 minAudio

    On this week's episode, Kris and Matt are joined by Fred Hebert and Reid Savage from Honeycomb to talk discuss building products with tiny teams, why code reviews are a useful bottleneck that we should keep around, and...

    Credit the people on this episode

  5. Git Out

    Oct 17, 20261 hr 40 minAudio

    Change is challenging but quite often the tools that we used to solve yesterday's problems are unfit for tomorrow's problems. In this episode, Kris and Matt are joined by Rain Paharia, one of Matt's colleagues at Oxide...

    Credit the people on this episode