[asterisk-bugs] [JIRA] (ASTERISK-24300) API docs don't conform to stated Swagger version

[Matthias Urlichs (JIRA)]

    [ https://issues.asterisk.org/jira/browse/ASTERISK-24300?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=246539#comment-246539 ] 

Matthias Urlichs edited comment on ASTERISK-24300 at 3/12/19 3:29 AM:
----------------------------------------------------------------------

Well, another year has gone by, Asterisk 16 is out and still uses Swagger 1.1, and the number of tools that can talk to Asterisk actually gets smaller as they're unmaintained (nobody else seems to use Swagger 1.x any more, AFAICT).

IMHO, long-term we need an /ari2/ endpoint that uses OpenAPIv3 instead (and then deprecate /ari/). 


was (Author: smurfix):
Well, another year has gone by, Asterisk 16 is out and still uses Swagger 1.1, and the number of tools that can talk to Asterisk actually gets smaller as they're unmaintained (nobody else seems to use Swagger any more, AFACT).

IMHO, long-term we need an /ari2/ endpoint that uses OpenAPIv3 instead (and then deprecate /ari/). 

> API docs don't conform to stated Swagger version
> ------------------------------------------------
>
>                 Key: ASTERISK-24300
>                 URL: https://issues.asterisk.org/jira/browse/ASTERISK-24300
>             Project: Asterisk
>          Issue Type: Bug
>      Security Level: None
>          Components: Documentation
>    Affects Versions: SVN, 12.5.1, 13.0.0-beta1
>            Reporter: Bradley Watkins
>
> For at least events.json, the stated Swagger version (in that case 1.2) is not what's actually in use.  It appears, based on some historical asterisk-dev mailing list posts, that an in-progress version of 1.2 was used.  However, now that 1.2 has been finalized I think it's important to update the models and code generation tools to that spec.
> As it stands, any tools built to work with the 1.2 standard will not function correctly against Asterisk's api docs.



--
This message was sent by Atlassian JIRA
(v6.2#6252)