https://tutsplus.com/course/how-to-build-a-hypermedia-driven-rest-api/ by @rhodesjason
In this video series we’ll walk through building a simple REST API with node.js and express. By focusing on nouns, verbs, and relationships, you'll also finish with a clear understanding of what hypermedia is all about and how emerging hypermedia-driven API standards can make all of our lives as developers a little easier. ~ Jason Rhodes
Code
Resources
nodemon instead of node to run your code, and now your process will automatically restart when your code changesDoes it the "wrong" way so we can learn why the "right" way maybe better.
Builds an "RPC style" API which in this case means that all requests will come in the form of POST requests and all responses would be returned in the body.
Tools
The current "RPC style" API works but it is:
New problems with the API after building a REST Level 1 version:
GET, POST, PUT, PATCH, DELETE etc200 OK for everything including errorsResources
We're using verbs to clearly speak the language of our API. But. The part that deals with the status codes is very confusing. Everything, even errors, return 200 OK.
Resources
Hypermedia As The Engine Of Application State
... we're using links as ways of getting around applications and saving state. But you don't have to know how to make those URLs. Each time you get a response from the server it will have with it all of the available locations that you can get to from the spot you're in and so it creates a map through your application.
Resources
Steve Klabnik Resources
As public APIs, hypermedia and REST become a priority for content providers, multiple standards have emerged.
Resources
The existing HTTP method, PUT, only allows a complete replacement of a document. The new HTTP method, PATCH, allows one to modify an existing HTTP resource.
Resources
The best advice for now (27/03/2014) is to be practical and stand on conventions.
Resources