as far as I know. Using rest, there are no restrictions HOW to build a REST API, I mean, it really depends on you. I have seen web services that use XML, JSON, and even some of them work directly on JS.
The idea behind the API is that any program can use the services you publish. Since REST uses the HTTP protocol, you can use basic HTTP authentication (session cookies and all these things), although sometimes web services use a public / private key instead
I would say that the best guide when creating an API is to learn how to use another. web services offered by flickr A good start ... but if you really need something more accurate, there are always good books about it
Good luck and have fun!
source share