| Return a list of ALL movies to the user |
/movies |
GET |
None |
A JSON object holding data about all the movies. Example:
[
{
"Genre": {
"Name": "Adventure",
"Description": "Adventure films typically involve characters embarking on a journey or quest, often featuring excitement, exploration, and risk-taking."
},
"Director": {
"Name": "Steven Spielberg",
"Bio": "Steven Allan Spielberg is an American film director, producer, and screenwriter. He is considered one of the founding pioneers of the New Hollywood era and one of the most popular directors and producers in film history. Spielberg's films have covered a wide range of genres, including adventure, science fiction, and historical dramas.",
"Birth": "1946-12-18T00:00:00.000Z",
"Death": null
},
"Actors": [],
"_id": "660ced34a8e808e3b590a90c",
"Title": "Jurassic Park",
"Description": "An industrialist invites some experts to visit his theme park of cloned dinosaurs. After a power failure, the creatures run loose, putting everyone's lives, including his grandchildren's, in danger.",
"ImagePath": "jurassicpark.png",
"Featured": true
},
{
"Genre": {
"Name": "Drama",
"Description": "Drama films are intended to portray realistic characters, settings, life situations, and stories."
},
"Director": {
"Name": "Quentin Tarantino",
"Bio": "Quentin Jerome Tarantino is an American film director, screenwriter, producer, and actor. He is known for his nonlinear storytelling, satirical subject matter, and extensive use of dialogue. Tarantino's films often explore themes of violence, pop culture, and vengeance.",
"Birth": "1963-03-27T00:00:00.000Z",
"Death": null
},
"Actors": [],
"_id": "660ceec8a8e808e3b590a90d",
"Title": "Pulp Fiction",
"Description": "The lives of two mob hitmen, a boxer, a gangster and his wife, and a pair of diner bandits intertwine in four tales of violence and redemption.",
"ImagePath": "pulpfiction.png",
"Featured": true
}
]
|
| Return data about a single movie by title. Example: |
/movies/[movieTitle] |
GET |
None |
A JSON object holding data about the requested movie:
{
"Genre": {
"Name": "Adventure",
"Description": "Adventure films typically involve characters embarking on a journey or quest, often featuring excitement, exploration, and risk-taking."
},
"Director": {
"Name": "Steven Spielberg",
"Bio": "Steven Allan Spielberg is an American film director, producer, and screenwriter. He is considered one of the founding pioneers of the New Hollywood era and one of the most popular directors and producers in film history. Spielberg's films have covered a wide range of genres, including adventure, science fiction, and historical dramas.",
"Birth": "1946-12-18T00:00:00.000Z",
"Death": null
},
"Actors": [],
"_id": "660ced34a8e808e3b590a90c",
"Title": "Jurassic Park",
"Description": "An industrialist invites some experts to visit his theme park of cloned dinosaurs. After a power failure, the creatures run loose, putting everyone's lives, including his grandchildren's, in danger.",
"ImagePath": "jurassicpark.png",
"Featured": true
}
|
| Return data about a genre by name (e.g., "Drama"). Example: |
/movies/genres/[genreName] |
GET |
None |
A JSON object holding data about the requested genre:
{
"Name": "Drama",
"Description": "Drama films are intended to portray realistic characters, settings, life situations, and stories."
}
|
| Return data about a director (bio, birth year, death year) by name |
/movies/director/[directorName] |
GET |
None |
A JSON object holding data about the requested director. Example:
{
"Name": "Steven Spielberg",
"Bio": "Steven Allan Spielberg is an American film director, producer, and screenwriter. He is considered one of the founding pioneers of the New Hollywood era and one of the most popular directors and producers in film history. Spielberg's films have covered a wide range of genres, including adventure, science fiction, and historical dramas.",
"Birth": "1946-12-18T00:00:00.000Z",
"Death": null
}
|
| Register a new user |
/users |
POST |
A JSON object holding data about the user to be added.
Username, Password, and Email are mandatory. Birthday and FavouriteMovies (array of movie IDs) are optional.
Example:
{
"Username": "Mary",
"Password": "iamcool-mary002",
"Email": "mary.loo.smith@gmail.com",
"Birthday": "1990-12-15"
}
|
A JSON object holding data about the newly added user and their new ID:
{
"Username": "Mary",
"Password": "iamcool-mary002",
"Email": "mary.loo.smith@gmail.com",
"Birthday": "1990-12-15T00:00:00.000Z",
"FavouriteMovies": [],
"_id": "66138760d23e6b6f7ccad769",
"__v": 0
}
|
| Update user information |
/users/[id] |
PUT |
A JSON object holding data to be updated for the user. Example:
{
"Password": "more-complex-pass-4-john-holiday",
"Email": "john.robert.doe@gmail.com"
}
|
A JSON object holding data about the updated user. Example:
{
"_id": "660cfe54a8e808e3b590a917",
"Username": "john_doe",
"Password": "more-complex-pass-4-john-holiday",
"Email": "john.robert.doe@gmail.com",
"Birthday": "1985-03-20T00:00:00.000Z",
"FavouriteMovies": [
"660cf441a8e808e3b590a915"
]
}
|
| Add a movie to the user's list of favorites |
/users/[id]/[movieId] |
POST |
None |
A JSON object holding data about the updated user, including their list of favourite movies. Example:
{
"_id": "660cfe54a8e808e3b590a917",
"Username": "john_doe",
"Password": "more-complex-pass-4-john-holiday",
"Email": "john.robert.doe@gmail.com",
"Birthday": "1985-03-20T00:00:00.000Z",
"FavouriteMovies": [
"660cf441a8e808e3b590a915",
"660ced34a8e808e3b590a90c"
]
}
|
| Remove a movie from the user's list of favorites |
/users/[id]/[movieId] |
DELETE |
None |
A JSON object holding data about the updated user, including their list of favourite movies where the specified movie is deleted. Example:
{
"_id": "660cfe54a8e808e3b590a917",
"Username": "john_doe",
"Password": "more-complex-pass-4-john-holiday",
"Email": "john.robert.doe@gmail.com",
"Birthday": "1985-03-20T00:00:00.000Z",
"FavouriteMovies": [
"660cf441a8e808e3b590a915"
]
}
|
| Deregister a user |
/users/[id] |
DELETE |
None |
A text message indicating whether the user with the specified ID was removed. Example:
User with id 66138760d23e6b6f7ccad769 was deleted
|