docs: document api endpoints

[greenpau]

Need documenting the API endpoints.

greenpau/go-authcrunch/pkg/authn/handle_json_beacon.go
greenpau/go-authcrunch/pkg/authn/handle_json_whoami.go
greenpau/go-authcrunch/pkg/authn/handle_json_login.go
greenpau/go-authcrunch/pkg/authn/handle_api_list_realms.go
greenpau/go-authcrunch/pkg/authn/handle_api_reload_realm.go
greenpau/go-authcrunch/pkg/authn/handle_api_metadata.go
greenpau/go-authcrunch/pkg/authn/handle_api_realm_info.go
greenpau/go-authcrunch/pkg/authn/handle_api_profile.go
greenpau/go-authcrunch/pkg/authn/handle_api_list_users.go

File to add:

• https://github.com/authcrunch/authcrunch.github.io/tree/main/docs/authenticate/api/profile.md
• https://github.com/authcrunch/authcrunch.github.io/tree/main/docs/authenticate/api/portal.md

[arryllopez]

Hello! If not assigned I would like to tackle the issue

[greenpau]

@arryllopez , this is awesome! Please do!

[greenpau]

@arryllopez , if you have questions, please let me know and we can hop on Google Meet.

[greenpau]

The #462 is also relevant here.

[greenpau]

@arryllopez , please don’t get discouraged by someone else’s submission. Come up with your own version. This exercise is about reverse engineering. @cnaples79 started something, but it resembles AI output.

When documenting, see the big picture, tell the story of “why” the endpoint and how to use and understand what circumstances, for example /api/profile is NOT administrative api. It is user profile management api. The /api/server in turn is server management api, could be called administrative.