Proposal for http://jsonapi.org/ Deprecations
One of the benefits of a hypermedia API is the ability to make changes to the response without breaking existing clients. Some types of change are handled for easily than others, e.g. renaming a resource and returning 301 Moved Permanently. However, if you were to rename an attribute or relationship your clients would not know where to find the new names. A common solution to this problem to adopt a policy of only adding attributes and relationships. Such a policy would prevent clients of loosing track of these values, but it comes at a price:
- more noise in your responses