mirror of
https://github.com/IT4Change/gradido.git
synced 2026-01-20 20:01:31 +00:00
77 lines
2.1 KiB
Markdown
77 lines
2.1 KiB
Markdown
# login server api
|
|
|
|
Gradido js-Frontend vereinfachte Zusammenarbeit mit Login-Server und Community-Server
|
|
|
|
Es ist mit einer Zusatz-Option möglich das Login und Registrieren via ajax-Request passiern kann.
|
|
Dafür muss in der Login-Server Config
|
|
|
|
unsecure.allow_passwort_via_json_request = 1
|
|
|
|
gesetzt sein.
|
|
|
|
In diesen Beispielen gehe ich jetzt davon aus, das du das gesamte Gradido Projekt mit Docker gebaut hast und auf dem lokalen Rechner laufen lässt.
|
|
|
|
Login
|
|
Einloggen über:
|
|
|
|
|
|
# unsecureLogin
|
|
|
|
POST http://localhost/login_api/unsecureLogin
|
|
```
|
|
data: {"username": "<username>", "password": "<password>"}
|
|
```
|
|
|
|
Wenn alles okay ist erhältst du:
|
|
```
|
|
{"state":"success", "session_id": <session_id as int>, "clientIP":"<client ip of user>",
|
|
"user": {
|
|
"created": <timestamp in seconds>,
|
|
"disabled": <true|false>, // login will fail if user is disabled
|
|
"email": "<email>",
|
|
"email_checked": <true|false>, // true if user has already clicked on email verification code link in his emails
|
|
"first_name": "<first nme>",
|
|
"group_alias": "<group alias, z.B. gdd1>",
|
|
"ident_hash": <int, currently not used>,
|
|
"last_name": "<last name>",
|
|
"public_hex": "<64 character hex (contain only a-f and 0-9)>",
|
|
"role": "<admin|none>", // should be only valid for login-server
|
|
"username": "<currently not used>",
|
|
"balance": <Gradido Cent, 4 Nachkommastellen (2 Reserve)>, // 174500 = 17,45 GDD
|
|
"id": <id in login-server db>,
|
|
"errorCount": <errors occured in this session, should be normally 0>
|
|
}}
|
|
```
|
|
|
|
Anmelden
|
|
Registrieren kannst du einen neuen Benutzer mit:
|
|
|
|
|
|
## createUser
|
|
|
|
POST http://localhost/login_api/createUser
|
|
```
|
|
data: {"email":"<email>", "first_name":"<first name>", "last_name":"<last name>" ,
|
|
"emailType": 2, "password":"<password>"}
|
|
```
|
|
|
|
Wenn alles okay ist erhältst du:
|
|
```
|
|
{"state":"success"}
|
|
```
|
|
|
|
Dann wurde für den Benutzer ein neues Konto angelegt, seine Schlüssel generiert und ihm eine Bestätigungs-Email geschickt.
|
|
|
|
|
|
## Logout
|
|
|
|
Abmelden
|
|
POST http://localhost/login_api/logout
|
|
```
|
|
data: {"session_id": <session_id as int>}
|
|
```
|
|
|
|
Wenn alles okay ist erhältst du:
|
|
```
|
|
{"state":"success"}
|
|
``` |