0

Estou realizando a documentação de uma API utilizando o Swaggwer, porém, não encontrei uma forma de descrever o que é cada campo do json.

Seguindo o exemplo abaixo, esse é o json que o Swagger gera de exemplo com os dados da minha api: Json exemplo gerado pelo Swagger

Mas precisaria descrever o que é cada campo, pois o outro desenvolvedor nem sempre saberá o que significa um "cd_emp" ou um "qtde_pend_pedv" por exemplo.

Mais ou menos o que eu queria, seria algo assim, como um comentário em frente a cada campo: Exemplo de descrição dos campos

É possível ou há alguma maneira parecida que possa usar para descrever cada coluna?

2
  • Por favor, esclareça seu problema ou forneça detalhes adicionais a fim de destacar exatamente o que você precisa. Da forma como está escrito atualmente é difícil dizer com exatidão o que você está perguntando.
    – Comunidade Bot
    Commented 30/11/2022 às 15:03
  • você pode adicionar informações na sua model que devem aparecer na descrição dos contratos (schemas), por exemplo usando ApiModelProperty. Tem um package para nodejs que lê isso, dê uma procurada Commented 30/11/2022 às 17:28

0

Você deve fazer log-in para responder a esta pergunta.

Pesquise outras perguntas com a tag .