SQSERVICES-1529 Swagger docs and endpoint deprecation for API version V2

[battermann]

https://wearezeta.atlassian.net/browse/SQSERVICES-1529

The API changes in this PR were also added here: https://wearezeta.atlassian.net/wiki/spaces/ENGINEERIN/pages/603095166/API+changes+v1+v2

Checklist

• The PR Title explains the impact of the change.
• The PR description provides context as to why the change should occur and what the code contributes to that effect. This could also be a link to a JIRA ticket or a Github issue, if there is one.
• changelog.d contains the following bits of information (details):
  • A file with the changelog entry in one or more suitable sub-sections. The sub-sections are marked by directories inside changelog.d.r?

[fisx]

Looks good to merge to me!

The only two clients of internal end-points outside wire-server/services are ibis and stern. We could check these, document the findings, and that would allow us to remove the deprecated internal end-points soon(ish).

@dkovacevic what internal end-points are you using for feature configuration

[battermann]

@fisx by adding Until 'V2 to the endpoint types they will no longer be published to the current swagger UI. I think it is good to keep the documentation anyway and I also added everything here: https://wearezeta.atlassian.net/wiki/spaces/ENGINEERIN/pages/603095166/API+changes+v1+v2