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

[Jonathan Harris (JIRA)]

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

Jonathan Harris commented on ASTERISK-24300:
--------------------------------------------

Another two years have gone by, and the version of Swagger in use is now almost a decade old. The node libraries are unmaintained and throw up a bunch of warnings. I agree with Matthias that it would be very beneficial to have a v2 (v3?!) endpoint so we could use current libraries. Thank you.

> 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
>            Severity: Major
>
> 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)