API Versions

Bill Moseley <[email protected]> Fri, 25 Jul 2008 06:44:24 -0700
Newsgroups gmane.text.xml.rpc.specification
Message-ID <[email protected]>
We would like to support multiple versions of our API.  That is, when
an update for our API is released continue to support For example, a
method foo.get might require an extra argument in a newer version.

What would you recommend to specify a version in the request?

1) Use a version in the endpoint URL?  Say our current endpoint is:

    http://localhost/rpc

    So modify the endpoint for the version?  Something like one
    of these:

    http://localhost/rpc/1.23
    http://localhost/rpc?version=1.23
    http://localhost/rpc-1.23

2) Add an argument (or named parameter in a stuct) in the payload:

    version => 1.23


3) Modify the method name?

    foo.get

    foo.get.1.23

Thanks,


-- 
Bill Moseley
[email protected]
Sent from my iMutt


------------------------------------

Yahoo! Groups Links

<*> To visit your group on the web, go to:
    http://groups.yahoo.com/group/xml-rpc/

<*> Your email settings:
    Individual Email | Traditional

<*> To change settings online go to:
    http://groups.yahoo.com/group/xml-rpc/join
    (Yahoo! ID required)

<*> To change settings via email:
    mailto:[email protected] 
    mailto:[email protected]

<*> To unsubscribe from this group, send an email to:
    [email protected]

<*> Your use of Yahoo! Groups is subject to:
    http://docs.yahoo.com/info/terms/