Utenti

Di seguito vengono riportate le API per la gestione da parte dell’amministratore degli account utente e addetto alle pulizie

Nuovo account

L’amministratore può creare un nuovo account fornendo le informazioni necessarie

URL : /api/users/

Metodo : POST

Autenticazione richiesta : SI

Permessi richiesti : ADMIN

Dati

{
    "username": "string",
    "password": "string",
    "authorities": [
	"ADMIN", "USER", "CLEANER"
    ]
}

Messaggi di successo

Condizione : I dati in input sono validi e il nuovo account è stato creato

Codice : 200 OK

Contenuto Ritorna le informazioni non sensibili dell’account appena creato

{
    "username": "string",
    "authorities": [
	"ADMIN", ...
    ]
}

Messaggi di errore

Lista utenti

Ritorna una lista di utenti al momento inseriti nell’applicazione, ognuno col proprio username e i permessi.

URL : /api/users/

Metodo : GET

Autenticazione richiesta : SI

Permessi richiesti : ADMIN

Messaggi di successo

Codice : 200 OK

Contenuto

[
    {
	"username": "user",
	"authorities": [ 
		"USER"
	]
    },
    ...
]

Messaggi di errore

Modifica utente

permette all’amministratore di modificare le informazioni di un acccount, ovvero username, password e credenziali

URL : /api/users/{username}

Metodo : PUT

Parametri URL : {username} lo username dell’account da eliminare

Autenticazione richiesta : SI

Permessi richiesti : ADMIN

Dati constraints

{
    "username": "user",
    "password": "password",
    "authorities": [
	"USER", ...
    ]
}

Messaggi di successo

Condizione : Dati inviati validi e utente presente

Codice : 200 OK

Contenuto :

{
    "username": "string",
    "authorities": [
	"ADMIN"
    ]
}

Messaggi di errore

Eliminazione account utente

Elimina l’account utente indicato

URL : /api/users/user/{username}

Parametri URL : {username} lo username dell’account da eliminare

Metodo : DELETE

Autenticazione richiesta : SI

Permessi richiesti : ADMIN

Messaggi di successo

Condizione : Se l’account esiste può essere eliminato

Codice : 200 OK

Contenuto :

{
	"username": "user",
	"authorities": [
		"USER"
	]
}

Messaggi di errore

Account

Stanze