The quest for a better API
Hi everyone, I added these two ideas: "API-first" development REST API versioning should be actually used I would appreciate your help in voting them up if you agree with them. Thanks...
Forum Discussion
Hi DougS,
Actually, it doesn't really matter if you think "vc" is a misfeature or not; the thing that matters is that Lithium refuses to make changes to the API because they would break existing code.
Even adding a new field is considered a breaking change.
As a result, we have to do a gazillion extra calls to get around API shortcomings.
If API details were frozen for each version, and "vc" is not used, there is no way that changing the API would break existing code, since existing code has no way of using the new API without the code being changed to use it.
Hi wmertens -- Your points are well taken. In order for Lithium to evolve the REST API, we need to use versioning. If adding a field, for example, would make a call more useful, then we shouldn't be prevented from doing so because it might "break" the call for someone else. We should create a second version of the call with the new field.
But, we also need to be careful. If we create new versions of a call every release (an extreme example), that certainly gives us a lot of flexibility, but it's very difficult to maintain and complicated for developers. You'd potentially have to look through tens of versions to choose the right one. Practically speaking, there is a middle ground and we're discussing what that would look like. No concrete plans at this point, but we agree that versioning is important.
