3 ms·

Can anyone recommend any resources about API design?

• elbenshira 12y ago
  Classic: http://www.slideshare.net/guestbe92f4/how-to-design-a-good-a-p-i-and-why-it-matters-g-o-o-g-l-e http://www.slideshare.net/guestbe92f4/how-to-design-a-good-a... RESTful Web APIs (http://shop.oreilly.com/product/0636920028468.do http://shop.oreilly.com/product/0636920028468.do) was a good starting point for understanding RESTful HTTP APIs.
• _pmf_ 12y 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.
  • monksy 12y 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.
• JoshTriplett 12y ago
  Read Rusty Russell's "easy to use versus hard to misuse": http://ozlabs.org/~rusty/index.cgi/tech/2008-03-30.html http://ozlabs.org/~rusty/index.cgi/tech/2008-03-30.html and http://ozlabs.org/~rusty/index.cgi/tech/2008-04-01.html http://ozlabs.org/~rusty/index.cgi/tech/2008-04-01.html
• johns 12y ago
  https://www.youtube.com/watch?v=aAb7hSCtvGw https://www.youtube.com/watch?v=aAb7hSCtvGw