Notes on designing of a REST API. Mostly from Google's Design Guide for REST APIs

rest_design_guide.md

• The core principle is to define named resources that can be manipulated using a small number of methods.
• resources and methods are nouns and verbs of the API
• resource names map to URLs and methods map to HTTP methods.

URI and URL
Further according to the contemporary view, the term "URL" does not refer to a formal partition of URI space; rather, URL is a useful but informal concept: a URL is a type of URI that identifies a resource via a representation of its primary access mechanism (e.g., its network "location"), rather than by some other attributes it may have. Thus as we noted, "http:" is a URI scheme. An http URI is a URL.