+1 to a versioned API. I don't think that I use it for anything at the moment, but I'm not 100% sure about all our apps. I think we might have a third-party one that uses it. As for PUT vs POST, I suppose strictly speaking PUT would be more appropriate for /svc/bib. In terms of difficulty, it would be fairly trivial to update our apps. It's worth remembering that the OCLC Connexion daemon "./misc/bin/connexion_import_daemon.pl" uses "/cgi-bin/koha/svc/import_bib". This script should probably also use PUT, but I have no idea if OCLC Connexion supports that. Since there are an indeterminate number of third-party software systems using the existing API, I'd recommend versioning and using v2 to handle things more RESTfully. David Cook Systems Librarian Prosentient Systems 72/330 Wattle St, Ultimo, NSW 2007 -----Original Message----- Date: Tue, 22 Jul 2014 00:42:35 +0000 From: Indranil Das Gupta <indradg@gmail.com> To: "koha-devel@lists.koha-community.org" <koha-devel@lists.koha-community.org> Subject: Re: [Koha-devel] RFC: /svc/ API Message-ID: <CAEm3SZ135wdeSV8uth63cQHi-B+UsdvxQiw+QesZD=Vo2kS+ew@mail.gmail.com> Content-Type: text/plain; charset=UTF-8 On Mon, Jul 21, 2014 at 7:46 PM, Chris Cormack <chrisc@catalyst.net.nz> wrote:
* Philippe Blouin (philippe.blouin@inlibro.com) wrote:
Hi, <snipped>
I think we you want to do something like this (change a published and in use API) then we should version it.
So that the current in use version can be version one, we make a new version 2 of the API people can transition to it. At some point in the future (maybe) we get rid of version 1
+1 Sounds reasonable. -- Indranil Das Gupta Phone : +91-98300-20971 Blog : http://indradg.randomink.org/blog IRC : indradg on irc://irc.freenode.net Twitter : indradg -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-==-=-=-=-=-=-=-=-=- Please exchange editable Office documents only in ODF Format. No other format is acceptable. Support Open Standards. For a free editor supporting ODF, please visit LibreOffice - http://www.documentfoundation.org ------------------------------