REST is a style of software architecture, often used in web. The design of Rails, for instance, is based a lot on REST. The idea behind this architecture is to have very similar interfaces to access all the resources in your system.

Recently I had to create 2 APIs in 3 months so I had to learn all I could in a very short time. I’d like to share some conclusions but giving the fact that to develop an API people usually say you need 10 years of experience take them with caution.

The common approach here is to add a parameter to your URL, something like:

http://myapp.com/api/v1/

Or:

http://myapp.com/api/1/

I personally prefer the first method since is more clear, Google uses that too.