KIALI-1329 Adding documentation to Metrics endpoints

[xeviknal]

** Describe the change **

1. Adding all the query params from metrics endpoints has been adapted to be in swagger format.
2. Fixed missing params in swagger for AppList endpoint.
3. Classified all the endpoints per resource type (Apps, Namespaces, Services, Workloads, Config).
4. Adding swagger documentation to old undocumented endpoints.

** Issue reference **
KIALI-1329

** Backwards incompatible? **
Yes.

NOTE: update your swagger installation to fix a infinit loop (go-swagger/go-swagger#1614) // remove its installation folder and run again make swagger-install

[lucasponce]

I think the "reporter" param is missing in the doc.
This was introduced in a previous PR:
https://github.com/kiali/kiali/blob/master/prometheus/metrics.go#L34
and it hits the inner API but not proper documented across the handlers.

[xeviknal]

@lucasponce comments addressed :)

[lucasponce]

LGTM
Thanks @xeviknal