REST API Development with Node.js

There are some online services that allow API developers to upload their documentation, as well as those that provide the web UI to test the API; for example, Mashape provides this service for free (see Figure 2-2).

1xx: Informational and only defined under HTTP 1.1.
2xx: The request went OK, here’s your content.
3xx: The resource was moved somehow to somewhere.
4xx: The source of the request did something wrong.
5xx: The server crashed due to some error in its code.

file’s name indicates the content type to the operating system and any other software trying to use it; so in the following case, the extension added to the resource’s URL (unique identifier) indicates to the server the type of representation wanted.
GET /api/v1/books.json
GET /api/v1/books.xml
Both identifiers reference the same resource—the list of books, but they request a different representation of it.
Note
This approach might seem easier to implement, and even understand, by humans, but it lacks the flexibility added by content negotiation and should only be used if there is no real need