Entrar Ainda não tem acesso?
1
resposta

Problemas em tentar usar o $ref no retorno 200

Referente ao curso Swagger: documentando suas APIs, no capítulo Schemas e atividade Faça como eu fiz

por Estudante
| 17.2k xp | 8 posts

Olá! Por favor, preciso de uma ajuda. Tentei substituir o retorno 200 por essa $ref fazendo da forma abaixo, mas não funciona, tentei algumas coisas, mas não consegui descobrir o problema.

No components, declarei assim, o retorno 200:

Ret200:

Ret200:
  200:
    description: Sucesso
    content:
      application/json:
        schema:
          $ref: "#/components/schemas/Especialidade"

No path usei assim, no segundo get:

 get:
    summary: Recupera uma entidade pelo ID 
      responses:
         $ref: "#/components/schemas/Ret200"
         404:

Observação, no código tá identado bonitinho, aqui não ficou tão legal. Muito obrigada!

1 resposta
por SARAH CRISTINA BATISTA DOS SANTOS
| 887.8k xp | 2113 posts
Alura Scuba Team Monitor/ fórum

Oi, como vai você? Espero que esteja bem!

Entendi que você está com problemas ao tentar usar o $ref no retorno 200 da sua API. Pelo que entendi do seu código, você está tentando referenciar um esquema chamado "Especialidade" no retorno 200.

Pelo que vejo, o problema pode estar na forma como você está referenciando o esquema. Certifique-se de que o caminho para o esquema "Especialidade" esteja correto. Verifique se você definiu corretamente o esquema "Especialidade" dentro da seção "components/schemas" e se o nome está correto.

Além disso, verifique se você está usando a sintaxe correta para referenciar o esquema no retorno 200. O $ref deve ser usado dentro do objeto "schema" do retorno 200, como você fez. Certifique-se de que não há nenhum erro de digitação ou falta de indentação.

Aqui está um exemplo de como ficaria a definição do retorno 200 com o $ref corretamente utilizado:

200:
  description: Sucesso
  content:
    application/json:
      schema:
        $ref: "#/components/schemas/Especialidade"

Lembre-se de substituir "Especialidade" pelo nome correto do seu esquema.

Espero ter ajudado!

Caso tenha dúvidas, fico à disposição

Abraços e bons estudos!