Endpoints: Account‐Component - bjoern621/PeerDrop GitHub Wiki

Account Component

Hier befindet sich die Endpunkt-Dokumentation des Account-Components.

POST /accounts

Legt einen neuen Benutzer an.

{
  "username" : "string",
  "password" : "string"
}

Felder

Status 400 (Bad Request):

{
  "error" : "Invalid JSON format."
}

{
  "error" : "Missing account data."
}

Status 409 (Conflict):

{
  "error" : "Username already exists."
}

POST /login

Loggt den Benutzer ein. Speichert dafür die User ID in Session und setzt auf dem Client-Gerät einen entsprechenden Cookie.

{
  "username" : "string",
  "password" : "string"
}

Felder

Status 200 (OK):

{
  "message" : "Logged in successfully"
}

Status 400 (Bad Request):

{
  "error" : "Invalid JSON format."
}

{
  "error" : "Invalid username"
}

{
  "error" : "Invalid password"
}

{
  "error" : "Missing account data."
}

POST /logout

Loggt den Benutzer aus. Bereinigt dafür die Session und entfernt den Cookie auf dem Client-Gerät.

Kein Body.

Status 200 (OK):

{
  "message" : "Logged out successfully"
}

GET /me

Gibt den Benutzernamen des Accounts zurück, wenn das Client-Gerät in der aktuellen Session angemeldet ist.

Kein Body.

Status 200 (OK):
```
{
  "message" : "string"
}
```
Felder:
- message: Benutzername
Status 401 (Unauthorized): Kein Body. Wird zurückgegeben, wenn:
- Benutzer nicht eingeloggt ist oder
- Benutzerprofil nicht in Datenbank gespeichert ist.

GET /me/status

Gibt zurück, ob das Client-Gerät angemeldet ist.

Kein Body.

Status 200 (OK):
```
{
  "status" : true
}
```
Wenn das Client-Gerät in der Session angemeldet ist.
```
{
  "status" : false
}
```
Wenn das Client-Gerät in der Session nicht angemeldet ist, oder
- der Benutzeraccount nicht existiert, oder
- der Cookie des Clients ein falsches Format hat.