23 comments

[ 3.1 ms ] story [ 59.6 ms ] thread
This is beyond useful.
The section on OAuth needs to be made better.
Of course, there is a lot of nuance in the OAuth spec(s), but we didn't feel the need to be that verbose for an "An Introduction to APIs". We'd love to hear more about what broad but important aspect of OAuth that we missed! We'll absolutely make revisions and updates.
Completely agree - that's the first time I've read a guide to oauth and actually understood it. So big thanks from me.
Nice introuction to APIs. Very helpful and easy to understand.
I find the layout to be very refreshing. Whoever put it together did a pretty sweet job since it doesn't feel like reading the usual technical guide on how to use XYZ.
very well written and refreshing as others said. +1 absolutely!
Really nice presentation. Clear, professional, interesting and useful.
Great document, so I'll bite, since they deserve it:

What is this Zapier really? What are some examples of what it can do?

These services that basically sound something like "With our tools, you can do anything with data!!" always confuse me.

Until otherwise convinced, I'm of the opinion that if you can do "everything", you do nothing.

They connect APIs.

They've defined a bunch of methods for popular APIs. You can then pipe the results into another API.

e.g. Watch Disqus comments and auto send thank you mail

Send email attachments to your Dropbox

Create Trello cards from Evernote items

Checkout the Directory, then click on an item - you'll see all the possible interactions:

https://zapier.com/zapbook/

Looks cool, but I really get a little tweaked when incomplete things are shared like this. To me, it's not useful if I can't read through and work the whole guide, which leaves this one somewhere between email-bait to get updates on the end or just regularly incomplete.
I see it as more of a multi-part blog series, where you can read the first few parts and wait for the rest, or you can wait until all parts have been written and read it all. In this case, it's better than a blog series, because you can be notified as soon as it's complete without having to keep checking back.