[ZEPPELIN-3973] REST API should be backward compatible

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 0.8.0
• Component/s: rest-api
• Assignee: Unassigned
• Reporter: Raz Yalov
• Created: 28/Jan/19 20:36
• Updated: 29/Jan/19 01:45

Description

The whole idea of an API is that it is backward compatible so that my code can handle changes gracefully. The current API is so poorly designed that even the version API itself broke compatibility between version 0.7.x and 0.8.x. I would expect that APIs would be 100% version compatible and if a need arises to change an API, you should introduce a version prefix such as /api/v1/xxxx and /api/v2/xxxx so that all calls within a version are not changing.