Request for feedback on proposed Bugzilla WebServices API changes

[David Lawrence]

In the past meetings both with the upstream Bugzilla community and within the small circle of BMO
developers, we have come up with some ideas on how to move the current API forward and improve it in
both functionality and user documentation. I would like to elicit some constructive feedback on the
two proposals I have outlined in comment0 of the bugs below. People with vested interest in the API
from a developer and consumer standpoint should be interested in the outcomes of these discussions.

Bug 1051056 - The REST API needs to be versioned so that new changes can be made that do not break compatibility
https://bugzilla.mozilla.org/show_bug.cgi?id=1051056

Bug 1038275 - Comprehensible documentation for the REST API
https://bugzilla.mozilla.org/show_bug.cgi?id=1038275

Thanks!
dkl

[Gervase Markham]

Post by David Lawrence
In the past meetings both with the upstream Bugzilla community and within the small circle of BMO
developers, we have come up with some ideas on how to move the current API forward and improve it in
both functionality and user documentation. I would like to elicit some constructive feedback on the
two proposals I have outlined in comment0 of the bugs below.

I have given a little feedback, and will give more after I return from
two weeks holiday :-)

Gerv

_______________________________________________
dev-apps-bugzilla mailing list
dev-apps-bugzilla-CzyLcWPZiU5YsZ3hbOqMTti2O/***@public.gmane.org
https://lists.mozilla.org/listinfo/dev-apps-bugzilla
-
To view or change your list settings, click here:
<http://bugzilla.org/cgi-bin/mj_wwwusr?user=gcbd-developers-Uylq5CNFT+***@public.gmane.org>

[Jasmin Sehic]

I would suggest to possibly go a step further and implement HATEOAS instead of simple url versioning

Regards,
Jasmin

Post by David Lawrence
In the past meetings both with the upstream Bugzilla community and within the small circle of BMO
developers, we have come up with some ideas on how to move the current API forward and improve it in
both functionality and user documentation. I would like to elicit some constructive feedback on the
two proposals I have outlined in comment0 of the bugs below. People with vested interest in the API
from a developer and consumer standpoint should be interested in the outcomes of these discussions.
Bug 1051056 - The REST API needs to be versioned so that new changes can be made that do not break compatibility
https://bugzilla.mozilla.org/show_bug.cgi?id=1051056
Bug 1038275 - Comprehensible documentation for the REST API
https://bugzilla.mozilla.org/show_bug.cgi?id=1038275
Thanks!
dkl
--
David Lawrence
-

-
To view or change your list settings, click here:
<http://bugzilla.org/cgi-bin/mj_wwwusr?user=gcbd-developers-Uylq5CNFT+***@public.gmane.org>