[Catalyst] API Versioning for Web Services

[Bill Moseley]

On Sun, Jul 27, 2008 at 06:42:23PM -0500, Wade.Stuart at fallon.com wrote:
> >     widget.1.get
> >     widget.2.get
> >     etc.
> >
>       Icky,  I think the API should be versioned -- not methods.  What if
> the methods across versions are not compatible (widget1 output used with
> foo2) versioning the api forces all methods to be used with their tested
> and versioned partners.  When you have 30 or 40 different revisions and
> developers start relying on mismatching methods from different versions
> that seems like a headache waiting to happen.

I completely agree.

I suppose a "version" XMLRPC parameter in the request payload is
possible, but I'm actually leaning more toward just using separate
endpoints:

    http://localhost:3000/rpc1.2
    http://localhost:3000/rpc1.3

or

    http://localhost:3000/rpc/1.2
    http://localhost:3000/rpc/1.3

or

    http://localhost:3000/rpc?version=1.2

-- 
Bill Moseley
moseley at hank.org
Sent from my iMutt