Fix swagger errors

[sapk]

Fix all the resting errors to have a valid swagger file.

They are still some warnings but nothing blocking.

Doing so I found that some request still misses son parameters for some POST/PUT/PATCH request. This means the a client generated from the swagger file will not work completely.

Fix #4088 by activating validation in drone
Should fix #4010.

[codecov-io]

Codecov Report

Merging #4220 into master will increase coverage by <.01%.
The diff coverage is 12.24%.

@@            Coverage Diff             @@
##           master    #4220      +/-   ##
==========================================
+ Coverage   19.96%   19.97%   +<.01%     
==========================================
  Files         153      153              
  Lines       30501    30514      +13     
==========================================
+ Hits         6091     6094       +3     
- Misses      23496    23506      +10     
  Partials      914      914

Impacted Files	Coverage Δ
routers/api/v1/repo/issue_comment.go	0% <0%> (ø)	⬆️
routers/api/v1/repo/file.go	0% <0%> (ø)	⬆️
routers/api/v1/repo/hook.go	18.66% <0%> (-0.46%)	⬇️
routers/api/v1/repo/repo.go	0% <0%> (ø)	⬆️
routers/api/v1/repo/milestone.go	0% <0%> (ø)	⬆️
routers/api/v1/repo/issue_tracked_time.go	0% <0%> (ø)	⬆️
routers/api/v1/misc/markdown.go	82.53% <100%> (+0.87%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 0ba165e...c232a71. Read the comment docs.

[sapk]

Ping @stevegt, if it can confirm that it solve #4010 to be used by his cli.

[sapk]

This one could maybe be in 1.5 milestone since it is only comments editing and that it can help use/generate swagger client. If not it will need to be backport I think.

[lunny]

LGTM

[stevegt]

Totally awesome @sapk! Thanks for the ping @bkcsoft! I'm leaving a conference right now, headed for the airport. Just pulled master so I can look while unplugged -- I was puzzling over the correct way to implement some of these fixes myself. This lets me get back to working on client side this week; will publish repos as I go. (/me is still in conference mode and can't remember if we already have a docs or other page for listing API clients...)