Expand my Community achievements bar.

Swagger Plugin Does Not Fully Support the External Documentation Object

Avatar

Level 3

If Swagger content is using the External Documentation Object, the HTML formatting isn’t correct in AEM Sites:

Swagger Version : 2.0

Example Codeblock in the Guides concpet : 

 

{
"openapi": "3.0.1",
"servers": [
{
"url": "https:google.com",
"description": "Generated server url"
}
],
"tags": [
{
"name": "Search",
"description": "Search Here.",
"externalDocs": {
"description": "Click here to search.",
"url": "google.com"
}
}]

}

 

Beaula123_0-1711524828414.png

 

1 Reply

Avatar

Community Advisor

HI @Beaula123 ,

You can use open API swagger specification to integrate a restful webservicewith adaptive form. In the POST specification of swagger yaml or json file you can put "consume", "produces" and "parameter" field. And in GET item you can mention how you want your response by giving "produces" and "consumes" value as "application/json" or "text/plain; charset=utf-8".


Thanks
Tarun