Olá, pessoal eu fui incumbido de uma missão de implementar o swagger em uma aplicação express, com finalidade de gerar o swagger.json para o deploy do apigateway da AWS.
Já tentei utilizar o swaggerJSDoc, swagger-ui-node... entre outros.
O mais próximo que eu cheguei do meu objetivo com o swaggerJSDoc, só que para ele funcionar eu precisar adicionar vários annotations nas rotas, como esse:
/**
* @swagger
* /add:
* post:
* summary: Add more animal
* description: Add animals to the list
* tags:
* - animals
* requestBody:
* content:
* application/json:
* schema:
* type: object
* properties:
* animals:
* type: array
* items:
* type: string
* responses:
* 200:
* description: Adds the animals in body
* schema:
* type: object
* properties:
* message:
* type: string
* default: 'Added'
*/
app.post('/add', (req, res) => {
// ...
});
Existe alguma forma de gerar esses annotations de forma automática, para não precisar fazer tudo na unha? Ou alguma outra forma de criar esse swagger.json a partir das routes, sem precisar escrever esses annotations?
{
"swagger": "2.0",
"info": {
"version": "2018-09-25T20:57:59Z",
"title": "swagger.json"
},
"host": "localhost",
"basePath": "/",
"schemes": [
"https"
],
"paths": { }
}