News for hackers. Stuff that matters.
Re:Ask HN: What are good reads for designing APIs? by ccallebs on Wednesday August 10, 2016 @12:46PM (#12263107)
You'll notice in this thread that (at 9 comments in) there are no repeated recommendations. If the question was "What are some good reads for learning about algorithms?" you'd probably see the same handful of books being praised by everyone.

Don't be overwhelmed by this though -- API design isn't an exact science. It's also very opinionated.

Personally, I would just start reading actual API documentation (GitHub is a great place to start -- their API is a joy to work with). Find things you like and don't like about it and try to figure out why those decisions were made.

Re:Ask HN: What are good reads for designing APIs? by derefr on Wednesday August 10, 2016 @04:49PM (#12264658)
> I would just start reading actual API documentation (GitHub is a great place to start -- their API is a joy to work with)

This would be a good related subthread: links to API docs for what people consider to be both great, and terrible, APIs.

Re:Ask HN: What are good reads for designing APIs? by OJFord on Wednesday August 10, 2016 @05:04PM (#12264745)
> This would be a good related subthread: links to API docs > for what people consider to be both great, and terrible, > APIs.

At least the great part has happened:

https://news.ycombinator.com/item?id=867972

There was one _much_ more recently (a week or two ago), but funnily enough the only one I can find is ~2.5k days old..

Related - best documented:

https://news.ycombinator.com/item?id=6224155

Re:Ask HN: What are good reads for designing APIs? by puddintane on Wednesday August 10, 2016 @06:20PM (#12265130)
I liked this recommendation a lot by vibhavs [1] (in your first link). Found the pdf thru Wayback machine [2]. Had a lot of really good tips to keep in mind.

[1] https://news.ycombinator.com/item?id=868102

[2] http://web.archive.org/web/20090520234149/http://chaos.troll...

Re:Ask HN: What are good reads for designing APIs? by supergeek133 on Wednesday August 10, 2016 @12:51PM (#12263144)
Agreed. Find APIs you like to work with, think about WHY you like to work with them.

People get into really philosophical discussions around versioning, resource structure, etc... but in reality think about what makes you like the APIs you like over another alternative. Then think about what you would do to make it even easier to use/integrate with.

There also with some APIs is the tradeoff of easy integration and long-term flexibility.. things like that.

Re:Ask HN: What are good reads for designing APIs? by levbrie on Wednesday August 10, 2016 @01:59PM (#12263638)
On that point, after you've read whichever of the many great recommendations you end up reading, don't get discouraged if you end up having to scrap the first several APIs you build. Part of the reason building APIs is so opinionated is that it's so difficult to do it well. Look at the API documentation for a bunch of different Google projects. Some of them are absolutely abominable. Others are quite good. Algolia has great documentation. When you get it wrong, you'll know. And that's all you really need to make sure you do better next time.
Re:Ask HN: What are good reads for designing APIs? by fapjacks on Thursday August 11, 2016 @04:42AM (#12266902)
I really enjoy working with Twilio's API [0]. Their documentation is great. It includes an ample number of examples. The API is also extremely easy to use.

[0] https://www.twilio.com/docs/api/rest

Re:Ask HN: What are good reads for designing APIs? by cloudjacker on Wednesday August 10, 2016 @01:36PM (#12263466)
lets look at how not to design an http API
Re:Ask HN: What are good reads for designing APIs? by philgo20 on Friday August 12, 2016 @11:53AM (#12276611)
Care to elaborate?
Re:Ask HN: What are good reads for designing APIs? by sd_sangit on Wednesday August 10, 2016 @01:15PM (#12263322)
spot on my friend !!