I hope that this becomes a go to guide for people developing JSON APIs so they know how to implement it correctly, or more importantly, how not to implement it.