Solucionado
Olá, espero que estejam bem. ^^
Tem alguns GET que não tem parâmetros, como na imagem abaixo.
)
Sendo que tem outros que já aparecem :
)
Independente dos conteúdos que estão nas imagens, o ponto é que em uma os parâmetros não existem, e na outra eles aparecem. Gostaria de saber o que deixaram de fazer pra que o parâmetro não aparecesse? Como eles são inseridos.. Ele não aparecer é algum problema ?
Desde já agradeço a atenção ^^
hoje, com a Alura e o Google Gemini
Opa tudo bem? A implementação depende da linguagem que está criando a API, caso seja PHP por exemplo, no teu documento de swagger precisa colocar a url completa com os parametros:
paths:
/users/{userId}:Já se for usar NodeJs na tua controller podemos usar decorators do swagger para montar a documentação
// http get request
@get
// set route
@route('/users/{userId}')Se tua API possui a rota padrão /v1 deve usar o atribulo basePath para que todas tuas rotas tenham ela
"basePath": "/v1"Segue um bom artigo sobre Swagger, porém em Ingles: https://medium.com/@benlugavere/documenting-your-node-js-api-painlessly-with-swagger-doctopus-3cf40024037
Também sempre bom ler a documentação da ferramenta: https://swagger.io/docs/
Espero ter ajudado ;)
Eu tinha visto a documentação , mas não conhecia esse artigo, muito obrigada pela ajuda ^^