URL deciphering

The URL is one of the most important components in describing a service. It should be short and descriptive, and should provide a natural hierarchy path structure to the resource. The resource names should be nouns; verbs should be avoided.

A well designed API should be intuitive and easy to use. If done poorly, it can make the service difficult to use and understand. URL query strings should only be utilized for filtering and specifying the ordering of the result set.