Improve swagger and hide some endpoints #86
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Improves swagger docs
Before:
![image](https://private-user-images.githubusercontent.com/2352112/360561425-384bb5ee-33a3-46c0-be81-7f58e01cc2fa.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkyNjc5NjYsIm5iZiI6MTczOTI2NzY2NiwicGF0aCI6Ii8yMzUyMTEyLzM2MDU2MTQyNS0zODRiYjVlZS0zM2EzLTQ2YzAtYmU4MS03ZjU4ZTAxY2MyZmEucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI1MDIxMSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNTAyMTFUMDk1NDI2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ZmNjMmYyNjUxNzZkZTY5M2NhZmM1Nzc2YTQyNTRkNDQ2YWEyZmI0YWI2ZDgyZjQyZDc1YzU1NWFkMGJiZjY4ZCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.6WgqeP7s1MwU595Yttb8FOq1Rd6hL9NgksQZgr4F8rE)
After:
![image](https://private-user-images.githubusercontent.com/2352112/360563007-57658d6e-0043-4e23-b9fd-a937edd0ead1.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MzkyNjc5NjYsIm5iZiI6MTczOTI2NzY2NiwicGF0aCI6Ii8yMzUyMTEyLzM2MDU2MzAwNy01NzY1OGQ2ZS0wMDQzLTRlMjMtYjlmZC1hOTM3ZWRkMGVhZDEucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI1MDIxMSUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNTAyMTFUMDk1NDI2WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9M2YwZTdlNmY5NGZjZTU0NjIzMDI2NTlkZjdmMWI4NjQ3ZWE2NDA0NzkxMDc0NmEyZDUyNzY2MzAzMThkODNhMSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QifQ.mJKhJjd_Jkm4FynpSOuGaGXFLy52zhrrzv6aUYfm-1E)
The PR also adds a small description for the endpoints and classify them in groups (tags):