[Koha-devel] Review on Koha Order Module/plugin API

[dcook at prosentient.com.au]

Hi Ola,

 

I've only skimmed the document, but I really dislike the proposal. It's not
really describing an API. It's describing a non-standard workaround. I've
seen integrations like this before, but I wouldn't recommend them,
especially not for a new development.

 

I'd suggest that the Koha plugin provides an API where the Vendor Service
can send the JSON in the body of a background POST request using AJAX. Once
that POST request is complete, they could then offer a link to navigate to
Koha. That link would be to the Koha plugin and include an identifier
returned by the earlier AJAX POST request. 

 

In Koha, the user logs in and sees the Vendor Service order as shown by the
Koha plugin, and then you can action that order from there however you like.
Easy.

 

You would need to provide authentication credentials to the Vendor Service,
but that's a reasonable thing to do when consuming an API. 

 

I hope that helps.

 

David Cook

Software Engineer

Prosentient Systems

72/330 Wattle St

Ultimo, NSW 2007

Australia

 

Office: 02 9212 0899

Online: 02 8005 0595

 

From: Koha-devel <koha-devel-bounces at lists.koha-community.org> On Behalf Of
Ola Andersson
Sent: Tuesday, 8 September 2020 12:41 AM
To: koha-devel at lists.koha-community.org
Subject: [Koha-devel] Review on Koha Order Module/plugin API
Importance: High

 

Dear Koha Developers,

 

Here in Sweden we have started a task group in the Swedish Koha User Group
to build a Order module/plugin to Koha that allow automatic influx of order
data directly from a book vendor into Koha. 

 

The API draft is described here:
<https://docs.google.com/document/d/13EIWxTlN3Wo-8OtJuwu5serQu-dl-zdpK1qY5BN
s0dk/edit#heading=h.jtxo4681sgpr>
https://docs.google.com/document/d/13EIWxTlN3Wo-8OtJuwu5serQu-dl-zdpK1qY5BNs
0dk/edit#heading=h.jtxo4681sgpr

 

We have had it posted for review in the Swedish user group - but we are
thinking it would be valuable to get the larger Koha community to give
feedback before we hire contractors to build the module/plugin.

 

Please share thoughts on the API and how to best implement it in Koha from a
developer/QA perspective. All comments are appreciated and anyone looking at
the Google docs above can send comments/suggestions into the document.

 

When the API is becoming more stable and comments have been looked at we
could move it into the Koha wiki site.

 

Please leave comments before 21 September 2020.

 

/Swedish Koha User Group - the book vendor module/plugin task group

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.koha-community.org/pipermail/koha-devel/attachments/20200908/924742fd/attachment.htm>