added endpoint documentation

This commit is contained in:
Leon Hoppe
2024-11-22 12:20:33 +01:00
parent 2bc8a5d70b
commit 16ef41800d
4 changed files with 56 additions and 2 deletions

View File

@@ -0,0 +1,21 @@
# HopFrame Endpoints
HopFrame currently only supports endpoints for authentication out of the box.
> **Hint:** with the help of the [repositories](../repositories.md) you can very easily create missing endpoints for HopFrame components yourself.
## All currently supported endpoints
> **Hint:** you can use the build-in [swagger](https://swagger.io/) ui to explore and test all endpoints of your application __including__ HopFrame endpoints.
### SecurityController
Base endpoint: `api/v1/authentication`\
**Important:** All primitive data types (including `string`) are return as a [`SingleValueResult`](./models.md#SingleValueResult)
| Method | Endpoint | Payload | Returns |
| ------ | -------- | ------- | ------- |
| PUT | login | [UserLogin](./models.md#UserLogin) | access token (string) |
| POST | register | [UserRegister](./models#UserRegister) | access token (string) |
| GET | authenticate | | access token (string) |
| DELETE | logout | | |
| DELETE | delete | [UserPasswordValidation](./models.md#UserPasswordValidation) | |