Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Adicionar Configuração para swagger #18

Closed
vitorAzevedo09 opened this issue Jul 20, 2024 · 2 comments · Fixed by #19
Closed

Adicionar Configuração para swagger #18

vitorAzevedo09 opened this issue Jul 20, 2024 · 2 comments · Fixed by #19
Assignees
Labels
documentation Improvements or additions to documentation

Comments

@vitorAzevedo09
Copy link
Contributor

vitorAzevedo09 commented Jul 20, 2024

Descrição

Esta issue propõe a adição da documentação Swagger à API do projeto para melhorar a clareza, facilidade de uso e integração com outros sistemas.

Objetivo

Implementar a documentação Swagger para descrever de forma detalhada os endpoints, parâmetros, tipos de resposta e exemplos de uso da API.

Justificativa

A documentação Swagger oferece uma interface interativa que facilita a compreensão e teste dos endpoints da API. Ela padroniza a documentação, promovendo a consistência e facilitando a integração com ferramentas de terceiros. Além disso, simplifica o processo de onboarding para novos desenvolvedores e ajuda na manutenção contínua do sistema, garantindo que a API seja sempre bem documentada e atualizada.

obs: Sugestão de utilização do módulo gin-swagger

@mffonseca
Copy link
Collaborator

@vitorAzevedo09 acabei de testar o PR e encontrei alguns pequenos detalhes.

  • Rotas não condizem exatamente com as definidas em http.StartServer
  • Cabeçalho da doc ausente

Captura de Tela 2024-07-24 às 08 22 19

Consegue subir um novo PR com esses ajustes?

No mais, ficou muito bom. Parabéns.

@vitorAzevedo09
Copy link
Contributor Author

Opa, consigo sim.

@mffonseca mffonseca moved this to Done in MentorTech Jul 28, 2024
@mffonseca mffonseca closed this as completed by moving to Done in MentorTech Jul 28, 2024
@mffonseca mffonseca added the documentation Improvements or additions to documentation label Jul 28, 2024
@mffonseca mffonseca linked a pull request Jul 28, 2024 that will close this issue
8 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
Status: Done
Development

Successfully merging a pull request may close this issue.

2 participants