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?
ApiModelProperty
. Tem um package paranodejs
que lê isso, dê uma procurada