Re: [asterisk-dev] OpenAPI 3.1 API description for ARI
it's really hard use current swagger documentation v1.1 is supported in swagger-ui only to 2.2 version Swagger UI Version Release Date OpenAPI Spec compatibility Notes 2.2.10 2017-01-04 1.1, 1.2, 2.0 tag v2.2.10 ari.asterisk.org doesnt work for me now (i'm not sure if its problem on my side) another problem is that swagger-ui doesnt implement basic auth a and auth in ARI cannot be disabled can community help with something? Dne 24/06/2022 v 22:45 Sean Bright napsal(a): On 6/24/2022 4:36 PM, James Finstrom wrote: I did convert and manually clean up the spec once. This obviously isn't maintained Ugh. Same. My intentions were good though: https://github.com/seanbright/asterisk-ari-openapi-spec PRs welcome? Maybe? -- _ -- Bandwidth and Colocation Provided by http://www.api-digital.com -- asterisk-dev mailing list To UNSUBSCRIBE or update options visit: http://lists.digium.com/mailman/listinfo/asterisk-dev
Re: [asterisk-dev] OpenAPI 3.1 API description for ARI
On 6/24/2022 4:36 PM, James Finstrom wrote: > I did convert and manually clean up the spec once. This obviously > isn't maintained Ugh. Same. My intentions were good though: https://github.com/seanbright/asterisk-ari-openapi-spec PRs welcome? Maybe?-- _ -- Bandwidth and Colocation Provided by http://www.api-digital.com -- asterisk-dev mailing list To UNSUBSCRIBE or update options visit: http://lists.digium.com/mailman/listinfo/asterisk-dev
Re: [asterisk-dev] OpenAPI 3.1 API description for ARI
I did convert and manually clean up the spec once. This obviously isn't maintained https://gist.github.com/jfinstrom/6f4e130804d5b2965fe9aab29d3b8ff8 On Fri, Jun 24, 2022 at 10:18 AM Joshua C. Colp wrote: > > On Fri, Jun 24, 2022 at 2:11 PM Nicolas HEDGER wrote: >> >> Hi, >> >> I noticed that ARI’s API description uses Swagger 1.1, which is at least a >> few years old. >> >> I was wondering if there’d be interest in an OpenAPI 3.1 version, in which >> case I’d be willing to contribute. >> >> It would probably allow using more current tools to generate API clients. > > > 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. > > -- > Joshua C. Colp > Asterisk Technical Lead > Sangoma Technologies > Check us out at www.sangoma.com and www.asterisk.org > -- > _ > -- Bandwidth and Colocation Provided by http://www.api-digital.com -- > > asterisk-dev mailing list > To UNSUBSCRIBE or update options visit: >http://lists.digium.com/mailman/listinfo/asterisk-dev -- James Finstrom Guy who does stuff that is sometimes cool gpg: https://github.com/jfinstrom.gpg This email was sent from a personal email account. The content of this email is not endorsed by my employer or any project I may be a part of. The contents of this email should be considered my opinion and not taken as any form of official response. Please keep your hands and feet in the ride while in motion. Please be sure to tip the wait staff. -- _ -- Bandwidth and Colocation Provided by http://www.api-digital.com -- asterisk-dev mailing list To UNSUBSCRIBE or update options visit: http://lists.digium.com/mailman/listinfo/asterisk-dev
Re: [asterisk-dev] OpenAPI 3.1 API description for ARI
On Fri, Jun 24, 2022 at 2:11 PM Nicolas HEDGER wrote: > Hi, > > I noticed that ARI’s API description uses Swagger 1.1, which is at least a > few years old. > > I was wondering if there’d be interest in an OpenAPI 3.1 version, in which > case I’d be willing to contribute. > > It would probably allow using more current tools to generate API clients. > 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. -- Joshua C. Colp Asterisk Technical Lead Sangoma Technologies Check us out at www.sangoma.com and www.asterisk.org -- _ -- Bandwidth and Colocation Provided by http://www.api-digital.com -- asterisk-dev mailing list To UNSUBSCRIBE or update options visit: http://lists.digium.com/mailman/listinfo/asterisk-dev
