Implementar o swagger

Oi, Flavio! Tudo bem?

Desculpa a demora por um retorno.

Utilizamos o verbo POST no Swagger para enviar dados para o servidor, sendo possível salvar informações no banco de dados, que pode ser um banco de dados de testes.

De fato, em um ambiente de produção real, não é aconselhável permitir que os usuários salvem dados diretamente na base de dados através do Swagger ou qualquer outra documentação de API, pois isso pode levar a sérios problemas de segurança e integridade dos dados. Dessa forma, a capacidade de salvar dados através do Swagger é mais útil em fases iniciais de desenvolvimento, prototipagem e ambientes de teste, mas não deve ser exposta em um ambiente de produção real sem as devidas proteções de segurança e validações adequadas.

A lógica por trás de deixar alguém usar o Swagger para salvar dados em uma base de dados útil também é a possibilidade verificar se os dados estão sendo corretamente processados e salvos no banco de dados, além de às vezes, é útil ter uma documentação de API interativa que permita aos desenvolvedores não apenas visualizar a estrutura da API, mas também interagir diretamente com ela para entender melhor como ela funciona.

Quanto à utilização do Swagger à parte do código, o Swagger pode realmente ser utilizado separadamente do projeto, como uma ferramenta independente de documentação, podemos instalá-lo e configurá-lo separadamente do projeto.

Em relação a vários projetos com vários endpoints, é possível colocar todos os endpoints de diferentes sistemas em um único arquivo YAML. O Swagger permite a definição de múltiplos caminhos e endpoints em um único arquivo, facilitando a organização e documentação de diferentes sistemas.

Somado a isso, se estivermos documentando os endpoints de vários sistemas diferentes, podemos usar o Docker para criar e gerenciar diferentes containers para cada sistema. Cada container pode ter sua própria instância do Swagger, permitindo documentar e acessar os endpoints de cada sistema separadamente.

Espero ter ajudado. Caso tenha ficado alguma dúvida, sinta-se à vontade em comunicar, estou à disposição!

Um forte abraço e bons estudos!