How To Design A Good API and Why it Matters

Channel:Google TechTalks · Length:1:00:19 · Published:2007-10-09 · Views:453717

Watch on YouTube

Summary

Joshua Bloch's Google Tech Talk on how to design good APIs and why it matters, with concrete principles and examples. It treats every programmer as an occasional API designer.

Why HN recommends it

HN repeatedly names it the best resource on API design, a staple answer to any 'how do I design an API' question.

Absolutely far and away the best resource that I found was this Google TechTalk by Joshua Bloch — HN, 2012

Python, Ruby & scripting languages · Software architecture & design

Subtitles (excerpt)

>> First, I would like to thank you and welcome you all to the latest in our series of talks on advance topics and programming languages. The purpose of these series of talks is to expose all of the great domain knowledge in programming languages that we have at Google. So that--what that means is that everybody in this audience, all of you geniuses who work for Google and myself discounted, should give a talk. So please, come to me, my name Jeremy Manson email me, IM me whatever and tell me what talk you are going to give and I will set it up and give you a talk. You don't have to be an author like Josh or some of the people we have coming up in order to do so. Josh--and we're running late. Josh didn't want me to build him up too much and give him a swell head. So, I want to introduce him. I'll just say that in a company full of geniuses, it's his star that shines probably the most brightly. And I just want to... >> BLOCH: I'll get you for that. >> I just want to introduce this man whose boot heel I am not worthy to lick, Joshua Bloch ladies and gentlemen. >> BLOCH: Normally at this point, I thank my introducer for the introduction but today I think I'll dispense with that formality.

On Hacker News

Nice article. I'd also highly recommend "How To Design A Good API and Why it Matters" video from Joshua Bloch (co-author of Java). He digs much deeper, mostly at code level rather than JSON level but the same principles apply. Even though this video is almost 20 years old, the topics are as significant today as they were back then. [VIDEO] — minzak, 2025-08
I'm building a public API in my current job and, a few weeks ago, I was scouting around for the good API design advice. Absolutely far and away the best resource that I found was this Google TechTalk by Joshua Bloch: [VIDEO] If you're interested in the topic and haven't seen it yet, I urge you to do so ASAP. — philbo, 2012-03
Obviously, this is marketing rather than a serious treatment of the topic. It seems to basically say: "in order to design a system, you should have a regular undergraduate Computer Science education" which seems maybe like a prerequisite (and maybe informative about their hiring process) but not very useful. However, for what it's worth, the two best resources I've seen for systems design are: Hi… — socratic, 2011-10
Here are some of my favorites: How To Design A Good API and Why it Matters [VIDEO] Agile Methods The Good, the Hype and the Ugly [LINK] — DanPristupov, 2018-10
a.) On java - one hour talk but good: * How To Design A Good API and Why it Matters [VIDEO] b.) General code structure - dont to read it cover to cover unless you like to, you will die of boredom, but definitely have a look in library. It will help you to think about code structure right way. * Refactoring: Improving the Design of Existing Code * Code Complete c.) Object Oriented Programming * De… — watwut, 2018-01

Related videos