[Koha-devel] RFC: /svc/ API

[David Cook]

+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 at gmail.com>
To: "koha-devel at lists.koha-community.org"
	<koha-devel at lists.koha-community.org>
Subject: Re: [Koha-devel] RFC: /svc/ API
Message-ID:
	<CAEm3SZ135wdeSV8uth63cQHi-B+UsdvxQiw+QesZD=Vo2kS+ew at mail.gmail.com>
Content-Type: text/plain; charset=UTF-8

On Mon, Jul 21, 2014 at 7:46 PM, Chris Cormack <chrisc at catalyst.net.nz>
wrote:
> * Philippe Blouin (philippe.blouin at 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


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