Add Auth API endpoints and examples

[soderluk]

What is the problem?

The Auth API endpoints and examples are missing.

What do you expect to see / happen?

I expect to see the Auth API endpoints

• GET/PUT /auth/v1/me
• POST /auth/v1/clients/{client_id}/secrets
• GET /auth/v1//clients/{client_id}
• POST /auth/v1/apps/{id}/tokens/{token_id}/reset
• GET /auth/v1/apps/{id}/tokens
• POST/GET /auth/v1/apps
• GET/PUT/DELETE /auth/v1/apps/{id}
  and examples for each of them.

[kyyberi]

Initial guide for this kind of situations has been drafted in API Design Guide.

https://platformoftrust.gitbook.io/api-design-guide/versioning/add-new-api-to-documentation

Any feedback about that would also be welcome while following it in adding the Auth API to documentation

[soderluk]

@kyyberi Sure, I'll do it using that guide.