Hacker News new | ask | show | jobs
by mwww 4333 days ago
Can anyone recommend any resources about API design?
4 comments
elbenshira 4333 days ago
Classic: http://www.slideshare.net/guestbe92f4/how-to-design-a-good-a...

RESTful Web APIs (http://shop.oreilly.com/product/0636920028468.do) was a good starting point for understanding RESTful HTTP APIs.

link
JoshTriplett 4333 days ago
Read Rusty Russell's "easy to use versus hard to misuse": http://ozlabs.org/~rusty/index.cgi/tech/2008-03-30.html and http://ozlabs.org/~rusty/index.cgi/tech/2008-04-01.html
link
_pmf_ 4333 days ago
For a very deep, thorough and painful treatment instead of feel-good books, read "Practical API Design" by Jaroslav Tulach. Yes, it's Java, but it exemplifies the fundamental tradeoff that the feel-good books ignore: the more powerful you make your API for users, the less potential for evolution and long-term maintenance your API retains.
link
monksy 4333 days ago
That is on my queue of books to buy. [Which is below my queue of books to read].

So shouldn't there be a way to balance these requirements?

It seems like we've ignored the ability to batch jobs, do async tasks etc. It sucks... but an API is out of my control.

link
johns 4332 days ago
https://www.youtube.com/watch?v=aAb7hSCtvGw
link