Prenotazioni

Di seguito vengono riportate le API che permettono le gestione delle prenotazioni

Stato di una postazione

Indica se una postazione è attualmente occupata o libera, e quando ci sarà il prossimo cambio si stato (da occupata a libera o da libera ad occupata).

URL : /api/reservations/desk/{deskID}/{timestamp}

Parametri URL :

• {deskID}: id della postazione
• {timestamp}: momento nel quale si vuole sapere lo stato

Metodo : GET

Autenticazione richiesta : SI

Permessi richiesti : USER

Messaggi di successo

Codice : 200 OK

Contenuto Ritorna lo stato corrente e il prossimo cambio

{
    "available": boolean,
    "nextChange": "time"
}

Messaggi di errore

Nuova prenotazione

Crea una prenotazione a nome dell’utente richiedente

URL : /api/reservations/reservation

Metodo : POST

Autenticazione richiesta : SI

Permessi richiesti : USER

Dati

Indicare postazione, timestamp di inizio e fine prenotazione. Tutti i campi vanno inviati e l’inizio deve essere strettamente prima della fine.

{
    "deskId": "id",
    "start": "time",
    "end": "time"
}

Messaggi di successo

Condizione : La prenotazione è valida ed è stata creata sul server

Codice : 200 OK

Contenuto

{
    "id": "string",
    "deskId": "string",
    "room": "string",
    "username": "string",
    "start": "time",
    "end": "time"
}

Messaggi di errore

Modifica Prenotazione

Modifica di una prenotazione già effettuata

URL : /api/reservations/reservation/{reservationID}

Parametri URL : {reservationID}, ID della prenotazione effettuata

Metodo : PUT

Autenticazione richiesta : SI

Permessi richiesti : USER, ADMIN

Dati constraints

{
    "deskId": "string",
    "start": "time",
    "end": "time"
}

Messaggi di successo

Condizione : I nuovi dati della prenotazione sono validi e l’utente richiedente è admin o è lo stesso che ha effettuato la prenotazione originariamente

Codice : 200 OK

Contenuto :

{
    "id": "string",
    "deskId": "string",
    "room": "string",
    "username": "string",
    "start": "time",
    "end": "time"
}

Messaggi di errore

Lista prenotazioni personali

Get the details of the currently Authenticated User along with basic subscription information.

URL : /api/reservations/view/personal

Metodo : GET

Autenticazione richiesta : SI

Permessi richiesti : USER

Messaggi di successo

Codice : 200 OK

Contenuto

[
    {
	"id": "string",
	"deskId": "string",
	"room": "string",
	"username": "string",
	"start": "time",
	"end": "time"
    },

    ...
]

Messaggi di errore

Lista tutte le prenotazioni

L’admin è in grado do visualizzare tutte le prenotazioni in un certo intervallo temporale

URL : /api/reservations/view/all

Parametri GET :

• from : timestamp inizio periodo
• to : timestamp fine periodo

Metodo : GET

Autenticazione richiesta : SI

Permessi richiesti : ADMIN

Messaggi di successo

Codice : 200 OK

Contenuto Un amministratore autenticato è in grado di visualizzare l’elenco delle prenotazioni attive nel periodo indicato

[
    {
	"id": "string",
	"deskId": "string",
	"room": "string",
	"username": "string",
	"start": "time",
	"end": "time"
    },

    ...
]

Messaggi di errore

Eliminazione prenotazione

Elimina una prenotazione

URL : /api/reservations/reservation/{reservationID}

Parametri URL : reservationID id della prenotazione fatta dall’utente

Metodo : DELETE

Autenticazione richiesta : SI

Permessi richiesti : USER

Messaggi di successo

Condizione : La prenotazione esiste e l’utente che ne ha richiesto la rimozione è lo stesso che l’ha effettuata

Codice : 200 OK

Contenuto :

{
    "id": "string",
    "deskId": "string",
    "room": "string",
    "username": "string",
    "start": "time",
    "end": "time"
}

Messaggi di errore

Stanze

Reports