Swagger v3 YAML format support

[LYUAN]

The latest Swagger v3 has YAML format.   Does AEM support Swagger definition in YAML format or it has to convert to JSON in order for AEM to parse?  Tried with petstore.yaml with that latest SP 14 and the create data source UI hang. 

[Pulkit_Jain_]

@LYUAN 

AEM forms currently support swagger 2.0 but recall a discussion around including support for 3.0 in future releases.

I will check and get back to you with a response to your questions on the YAML format as well.

[workflowuser]

you can use YAML format, does not have to be in JSON

yes  AEM Forms supports OpenAPI Specification version 2.0 (fka Swagger).

[LYUAN]

We've tried with petstore.yaml with SP 14 and it hang and cannot finish during cloud data source creation.  The error log showing AEM is trying to parse it as JSON via Google JSON parser and failed with null pointer errors.   It would be great if the success steps in SP 14 can be shared.   Thanks a lot.

[Mayank_Gandhi · Accepted solution]

@LYUAN only v2 is supported, I tested pet store on my local it worked fine, send me your YAML(inbox the link)

[LYUAN]

@Mayank_Gandhi, thank you for confirming that only v2 supported.   Tested v2 YAML and JSON and both work.  https://petstore3.swagger.io/api/v3/openapi.yaml was the URL tested and failed, which is the V3 version.  This explains why it didn't work.  Looking forward to see AEM supporting v3 API in the future.

[Mayank_Gandhi]

@LYUAN you may raise a feature request for the same. 

Happy to help!

[Pulkit_Jain_]

@Mayank_Gandhi @LYUAN 

A feature pack request to support V3 is already logged and will be supported in future releases.

[DigitalDanCreates]

@Pulkit_Jain_ Is this supported now?

[GirishBedekar]

Most likely not, but 

let pulkit confirm