Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/danijeldragicevic/cinema-room-rest-service
Service who is able to book and return seat in cinema room.
https://github.com/danijeldragicevic/cinema-room-rest-service
gradle hyperskill-solutions java-11 lombok-gradle spring-boot spring-mvc spring-validation
Last synced: 6 days ago
JSON representation
Service who is able to book and return seat in cinema room.
- Host: GitHub
- URL: https://github.com/danijeldragicevic/cinema-room-rest-service
- Owner: danijeldragicevic
- License: apache-2.0
- Created: 2022-07-28T10:28:57.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-08-29T10:23:45.000Z (over 1 year ago)
- Last Synced: 2024-11-07T10:35:52.606Z (about 2 months ago)
- Topics: gradle, hyperskill-solutions, java-11, lombok-gradle, spring-boot, spring-mvc, spring-validation
- Language: Java
- Homepage:
- Size: 76.2 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Cinema Room REST Service
Backend service who is able to book and return seat in cinema room.
Service is also able to show statistics about number of sold tickets, available seats and earned income.
- All users can see available seats.
- All users can purchase and return a seat.
- Only authenticated users can see statistics about booked seats and sold tickets.
Service use authorization based on URL parameters.
# Technology
- Java 11
- Spring Boot 2.7.1 (Spring Web MVC, Spring Validation, Project Lombok)
- Gradle 7.4
# To run application:
Navigate to the project root directory and run **./gradlew bootRun**
# Exposed endpoints:
By default, service will run on **http://localhost:28852**
Following endpoints will be exposed:
| Methods | Urls | Actions |
|---------|---------------------------------|-----------------------------------------|
| GET | /api/seats | Show all available seats |
| GET | /api/stats?password=super_secret | Show statistics |
| POST | /api/purchase | Book a seat |
| POST | /api/return | Return booked seat |
# Examples
**Example 1:** GET /api/seats
```
{
"rows": 9,
"columns": 9,
"available_seats": [
{
"row": 1,
"column": 1,
"price": 10
},
{
"row": 1,
"column": 2,
"price": 10
},
.....
{
"row": 9,
"column": 8,
"price": 8
},
{
"row": 9,
"column": 9,
"price": 8
}
]
}
```
Status code: 200 (OK)
**Example 2:** POST /api/purchase
```
{
"row": 1,
"column": 1
}
```
Status code: 200 (OK)
```
{
"token": "5115505f-c2a7-4407-8670-77abc5390957",
"booked_seats": [
{
"row": 1,
"column": 1,
"price": 10
}
]
}
```
**Example 3:** POST /api/purchase
```
{
"row": 1,
"column": 1
}
```
Status code: 400 (Bad Request)
```
{
"error": "The seat has been already purchased!"
}
```
**Example 4:** POST /api/return
```
{
"token_XYZ": "5115505f-c2a7-4407-8670-77abc5390957"
}
```
Status code: 400 (Bad Request)
```
{
"error": "The token key or value is wrong!"
}
```
**Example 5:** POST /api/return
```
{
"token": "5115505f-c2a7-4407-8670-77abc5390957_XYZ"
}
```
Status code: 400 (Bad Request)
```
{
"error": "The token key or value is wrong!"
}
```
**Example 6:** POST /api/return
```
{
"token": "5115505f-c2a7-4407-8670-77abc5390957"
}
```
Status code 200 (OK)
```
{
"returned_seats": [
{
"row": 1,
"column": 1,
"price": 10
}
]
}
```
**Example 7:** GET /api/stats?password_xyz=super_secret
```
{
"error": "Missing query parameter password!"
}
```
Status code: 400 (Bad Request)
**Example 8:** GET /api/stats?password=super_secret_xyz
```
{
"error": "The password value is wrong!"
}
```
Status code: 401 (Unauthorized)
**Example 8:** GET /api/stats?password=super_secret
```
{
"current_income": 10,
"available_seats": 80,
"sold_tickets": 1
}
```
Status code: 200 (OK)
# Licence
[](https://opensource.org/licenses/Apache-2.0)