<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><div class="">Understood,</div><div class=""><br class=""></div><div class="">I’ve identified at least the following cases where the current definition is used.</div><div class=""><br class=""></div><div class="">- <a href="https://github.com/asterisk/asterisk/blob/master/rest-api-templates/swagger_model.py" class="">https://github.com/asterisk/asterisk/blob/master/rest-api-templates/swagger_model.py</a> not entirely sure what this does</div><div class="">- <a href="https://github.com/asterisk/asterisk/blob/master/tests/test_ari.c" class="">https://github.com/asterisk/asterisk/blob/master/tests/test_ari.c</a>, which runs ARI’s tests, I assume</div><div class="">- <a href="https://github.com/asterisk/asterisk/blob/master/rest-api-templates/make_ari_stubs.py" class="">https://github.com/asterisk/asterisk/blob/master/rest-api-templates/make_ari_stubs.py</a>, to render the wiki documentation</div><div class=""><br class=""></div><div class="">I’d be grateful for any help identifying any additional references, if any.</div><div class=""><br class=""></div><div class="">Regarding backwards compatibility, I was not planning on changing anything in the API if that’s what you mean, only to update the definition file and related tests/docs.</div><br class=""><div class="">
<div>Nicolas HEDGER</div><div class=""><br class=""></div><br class="Apple-interchange-newline">
</div>
<div><br class=""><blockquote type="cite" class=""><div class="">On 24 Jun 2022, at 19:18, Joshua C. Colp <<a href="mailto:jcolp@sangoma.com" class="">jcolp@sangoma.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><div dir="ltr" class=""><div dir="ltr" class="">On Fri, Jun 24, 2022 at 2:11 PM Nicolas HEDGER <<a href="mailto:nicolas@hedger.ch" class="">nicolas@hedger.ch</a>> wrote:<br class=""></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi,<br class="">
<br class="">
I noticed that ARI’s API description uses Swagger 1.1, which is at least a few years old.<br class="">
<br class="">
I was wondering if there’d be interest in an OpenAPI 3.1 version, in which case I’d be willing to contribute.<br class="">
<br class="">
It would probably allow using more current tools to generate API clients.<br class=""></blockquote><div class=""><br class=""></div><div class="">I'm sure someone would like it. The issue though is not just writing the definitions. The existing JSON files are actually used to produce generated base code for things so that also has to change. There would also need to be backwards compatibility present, to be allowed in older versions.</div></div><div class=""><br class=""></div>-- <br class=""><div dir="ltr" class="gmail_signature"><div dir="ltr" class=""><div class=""><div dir="ltr" class=""><div class=""><div dir="ltr" class=""><div dir="ltr" class=""><div dir="ltr" class=""><div dir="ltr" class=""><div style="font-family:tahoma,sans-serif" class=""><font color="#073763" class="">Joshua C. Colp</font></div><div style="font-family:tahoma,sans-serif" class=""><font color="#073763" class="">Asterisk Technical Lead</font></div><div style="font-family:tahoma,sans-serif" class=""><font color="#073763" class="">Sangoma Technologies</font></div><div style="font-family:tahoma,sans-serif" class=""><font color="#073763" class="">Check us out at <a href="http://www.sangoma.com/" target="_blank" class="">www.sangoma.com</a> and <a href="http://www.asterisk.org/" target="_blank" class="">www.asterisk.org</a></font><br class=""></div></div></div></div></div></div></div></div></div></div></div>
-- <br class="">_____________________________________________________________________<br class="">-- Bandwidth and Colocation Provided by <a href="http://www.api-digital.com" class="">http://www.api-digital.com</a> --<br class=""><br class="">asterisk-dev mailing list<br class="">To UNSUBSCRIBE or update options visit:<br class=""> <a href="http://lists.digium.com/mailman/listinfo/asterisk-dev" class="">http://lists.digium.com/mailman/listinfo/asterisk-dev</a></div></blockquote></div><br class=""></body></html>