The API should have versioning.

ZeitOnline / content-api

The ZEIT ONLINE content API

http://developer.zeit.de

Other

28 stars 3 forks source link

The API should have versioning. #13

Open ctriroli opened 11 years ago

ctriroli commented 11 years ago

There should be an endpoint-identificator or a parameter that allows versioning of the api requests. That way old api versions and newer api versions could coexist within the same codebase.

spier commented 11 years ago

It is an almost religious discussion whether or not APIs should be versioned. Therefore I don't think that there is right or wrong answer to this - it depends :)

I believe that as long as the ZEIT API is in Beta, it can easily change its signature without necessarily requiring a new version. Of course it would be nice to let all Application developers know when that happens, so that we know when our Apps will break.