Introduction - Shared Desk Docs

Alternativ kann auch eine Swagger UI zur Erkundung genutzt werden. Die Swagger UI kann unter production.shared-desk.cloud/swagger-ui/ aufgerufen werden. Die Open API Spezifikation kann unter production.shared-desk.cloud/api-docs abgerufen werden.

Fast alle Endpunkte in Shared Desk sind durch JWT (JSON Web Token) geschützt. Das bedeutet, dass ein gültiges JWT im Header der Anfrage enthalten sein muss, um auf die Endpunkte zuzugreifen. Wenn kein JWT vorhanden ist oder das JWT ungültig ist, wird der Zugriff verweigert.

Authentication

Manage user authentication, including registration, login, token refresh, password changes, and token invalidation.

Department

Create, read, update, and delete departments, as well as manage department-related reports and images.

Desk

Manage desks, including creation, deletion, retrieval, equipment assignment, user assignment, and reporting.

Equipment

Manage equipment, including creation, deletion, retrieval, and association with desks.

Password

Handle password reset requests and password updates with tokens.

Report

Create, read, update, and delete reports related to defects or issues.

Reservation

Manage desk reservations, including creation, cancellation, retrieval, and splitting.

Room

Create, read, update, and delete rooms, and manage room-related reports.

Search

Perform advanced searches for departments, rooms, desks, reports, and users.

Self

Manage your own profile information and profile picture.

Session

Manage user sessions, including retrieval and deletion.

Stats

Retrieve system statistics and usage data.

User

Manage users, including creation, deletion, enabling/disabling, retrieval of user details, reservations, and sessions.

User Avatar

Manage user avatars, including retrieval, upload, and deletion.