Adicionar Swagger para documentar API

[ramos-ph]

Atualmente, estamos utilizando um arquivo REFERENCE.md para documentar a API.

Isso não é bom porque não temos uma forma de testar com facilidade. Podemos adicionar um documento com Swagger para documentar e deixar testável a API.

Você poderia resolver essa Issue com um Pull Request?

• [x] Sim, eu tenho tempo e posso começar.
• [ ] Sim, eu tenho tempo mas precisaria de alguém para me direcionar.
• [ ] Não, eu não tenho tempo mas poderia solucionar.
• [ ] Não, eu não tenho tempo e não sei por onde começar.

[AldairAvelino]

Atualmente, estamos utilizando um arquivo REFERENCE.md para documentar a API.

Isso não é bom porque não temos uma forma de testar com facilidade. Podemos adicionar um documento com Swagger para documentar e deixar testável a API.

Você poderia resolver essa Issue com um Pull Request?

• [x] Sim, eu tenho tempo e posso começar.
• [x] Sim, eu tenho tempo mas precisaria de alguém para me direcionar.
• [ ] Não, eu não tenho tempo mas poderia solucionar.
• [ ] Não, eu não tenho tempo e não sei por onde começar.