Solucionado (ver solução)
Solucionado
(ver solução)
2
respostas

Swagger - GET

Olá, espero que estejam bem. ^^

Tem alguns GET que não tem parâmetros, como na imagem abaixo.

![](Insira aqui a descrição dessa imagem para ajudar na acessibilidade )

Sendo que tem outros que já aparecem : ![](Insira aqui a descrição dessa imagem para ajudar na acessibilidade )

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 ^^

2 respostas
solução!

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 ^^