A reading list for learning about ETags.
This will review solving the "Lost Update" problem with ETags within a Laravel 4 RESTful API. This builds off of previous ETag related articles.
There are many articles describing what a
Hypermedia API is. Many have a lot of jargon and cover a lot of topics. This one does neither. Learn what a Hypermedia API is on a basic level.
This 2010 video of Jon Moore's talk is extremely good for connecting the dots on just what a Hypermedia API is and might look like.
I last wrote about ETags in context of Conditional GETs, which allow a server to see if a resource has been modified since the last time a client checked. If it has not been modified, the server can return a
304 Not Modified response.
My curiosity about ETags (Entity Tags) was first piqued when reading over Github's API documentation. Looking into them, I saw that there explanation often pointed to them as a "cacheing" mechanism.
In looking to build a RESTful API, an important consideration is how to handle errors. Most errors are displayed to users in HTML, as these are web applications. However, API's need some special care.