We should do as we usually do: set a new context for URIs (/rest/ ?) and implement a RESTfull API there, following all the standards, and versioned from the beggining.

We could use CGI::Application::Dispatch, merge koha-restfull and work on top of that (it should be discussed whether we agree on the current API or not), or even do it with a framework, like Dancer [1].

And then have a clear deprecation path for the old API.

Would be happy to work on that if more people were interested.

[1] http://irc.koha-community.org/koha/2014-07-18#i_1538096



On Wed, Jul 23, 2014 at 9:21 PM, David Cook <dcook@prosentient.com.au> wrote:
Ah, right you are, Galen. It does use a socket. Yeah, that should be trivial to update connexion_import_daemon.pl.

None of our folks use OCLC, but that's good to know.

Going back to my earlier email, MarcEdit would probably benefit from a richer Koha API as well.

David Cook
Systems Librarian
Prosentient Systems
72/330 Wattle St, Ultimo, NSW 2007

-----Original Message-----
From: Galen Charlton [mailto:gmc@esilibrary.com]
Sent: Thursday, 24 July 2014 1:22 AM
To: David Cook
Cc: koha-devel@lists.koha-community.org
Subject: Re: [Koha-devel] RFC: /svc/ API

Hi,

On Tue, Jul 22, 2014 at 5:11 PM, David Cook <dcook@prosentient.com.au> wrote:
> +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.

Also +1 to a versioned API.

> This script should probably also use PUT, but I have no idea if OCLC
> Connexion supports that.

I don't believe it matters as far as Connexion is concerned, as it only talks to connexion_import_daemon.pl via a raw socket.

> 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.

MarcEdit is one program I know that uses the current API to inject records into a Koha database.

Regards,

Galen
--
Galen Charlton
Manager of Implementation
Equinox Software, Inc. / The Open Source Experts
email:  gmc@esilibrary.com
direct: +1 770-709-5581
cell:   +1 404-984-4366
skype:  gmcharlt
web:    http://www.esilibrary.com/
Supporting Koha and Evergreen: http://koha-community.org & http://evergreen-ils.org


_______________________________________________
Koha-devel mailing list
Koha-devel@lists.koha-community.org
http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
website : http://www.koha-community.org/
git : http://git.koha-community.org/
bugs : http://bugs.koha-community.org/



--
Tomás Cohen Arazi
Prosecretaría de Informática
Universidad Nacional de Córdoba
✆ +54 351 5353750 ext 13168
GPG: B76C 6E7C 2D80 551A C765  E225 0A27 2EA1 B2F3 C15F