Not Facebook. Not Disqus either. Not Google sheets. Oh, yeah, and definitely not Ebay.

To me a good REST API makes getting started easy. If I spend the first few hours with your framework trying to get oauth setup that's not a good sign.

Second way, imo, to design a good API is to not be pretentious. We should be able to guess where to look for things without having to learn any $5 words.

A good interaction to get a users photos should look like this:

- /get-all-photos/userId

That returns a JSON object with everything you need to know about the users photos.

For example: the ONE url to the photo, title, caption

Oh, and no paging and dont you EVER phone home in some weird alien way (embed a .gif to communicate, what?)!