Good REST is an API that's easy to understand with a little documentation so that a human can easily write a client for it. Bad REST is an API that makes a developer say, "damn, I wish this was SOAP." ...