Movie Catalog Api

Simple REST Api that maintains a Movie catalog.

📝 Table of Contents

Getting Started
Deployment
Usage
ER Diagram
Project Structure
Api Calls
Built Using
TODO
Authors

🏁 Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

Clone this project with this bash command:

git clone https://github.com/DonNy88/nestjs-movie-catolg

For running this NestJS Application you need Node.js, Nest CLI, Yarn Docker and Docker Compose. If you do not have these things yet here below you can find where to get them.

Docker for Windows Link
Docker for OS X Link
Docker compose Link
Node.js Link
Nest CLI Link
Yarn Link

🚀 Deployment

Please, see TODO file.

🎈 Usage

For run this Spring Boot Application use this command:

docker-compose up

🔧 Running the tests

yarn test

ER Diagram

Api Calls

Movie Endpoints

GET /movies/all

Fetch all movies present on the system

Respone Body example

{
  "status": "OK",
  "message": "Success",
  "body": [
    {
      "id": 1,
      "title": "Mummy",
      "overview": "The best movie",
      "duration": 300,
      "rating": 4,
      "movieDirector": {
        "id": 1,
        "name": "Donald",
        "middleName": "Emeka",
        "surname": "Achugo"
      }
    },
    {
      "id": 2,
      "title": "Mask",
      "overview": "The second best movie",
      "duration": 230,
      "rating": 3,
      "movieDirector": {
        "id": 1,
        "name": "Donald",
        "middleName": "Emeka",
        "surname": "Achugo"
      }
    }
  ]
}

or

{
  "status": "OK",
  "message": "Success",
  "body": []
}

GET /movies?movieId={}

Fetch a movie by movieId

Respone Body example

{
  "status": "OK",
  "message": "Success",
  "body": {
    "id": 2,
    "title": "Mask",
    "overview": "The second best movie",
    "duration": 230,
    "rating": 3,
    "movieDirector": {
      "id": 1,
      "name": "Donald",
      "middleName": "Emeka",
      "surname": "Achugo"
    }
  }
}

Exception Cases

Status Code 404 NOT FOUND

{
  "status": "NOT_FOUND",
  "message": "No movie found",
  "body": null
}

POST /movies

Add a Movie into the catolg

Request Body example

{
  "title": "Mummy", // Title of the movie
  "overview": "The best movie of the world", // Description of the movie
  "duration": 300, // Duration in minutes of the movie
  "rating": 3, // Rating of the movie from 1 to 5
  "movieDirectorId": 1, // Movie director id. NB: the movie director has been saved before
}

Response Body example

{
  "status": "CREATED",
  "message": "Success",
  "body": {
    "id": 3,
    "title": "Mummy",
    "overview": "The second best movie",
    "duration": 300,
    "rating": 3,
    "movieDirector": {
      "id": 1,
      "name": "Donald",
      "middleName": "Emeka",
      "surname": "Achugo"
    }
  }
}

Exception Cases

Status Code 404 NOT FOUND

{
  "status": "NOT_FOUND",
  "message": "No Movie Director found",
  "body": null
}

PUT /movies

Update a Movie

Request Body example

{
  "title": "Mummy", // Title of the movie
  "overview": "The best movie of the world", // Description of the movie
  "duration": 300, // Duration in minutes of the movie
  "rating": 3, // Rating of the movie from 1 to 5
  "movieDirectorId": 1, // Movie director id. NB: the movie director has been saved before
}

Response Body example

{
  "status": "OK",
  "message": "Success",
  "body": {
    "id": 3,
    "title": "Mummy",
    "overview": "The second best movie",
    "duration": 300,
    "rating": 3,
    "movieDirector": {
      "id": 1,
      "name": "Donald",
      "middleName": "Emeka",
      "surname": "Achugo"
    }
  }
}

Exception Cases

Status Code 400 BAD REQUEST

{
  "status": "BAD REQUEST",
  "message": "No arguments provided",
  "body": null
}

Status Code 404 NOT FOUND

{
  "status": "NOT_FOUND",
  "message": "No movie found",
  "body": null
}

Status Code 404 NOT FOUND

{
  "status": "NOT_FOUND",
  "message": "No Movie Director found",
  "body": null
}

DELETE /movies?movieId={}

Remove a Movie by movieId

Exception Cases

Status Code 404 NOT FOUND

{
  "status": "NOT_FOUND",
  "message": "No movie found",
  "body": null
}

GET /movies/searchByRating?aboveRating={}

Fetch movies where the rating is greater than or equals to aboveReting

Response Body example

{
  "status": "OK",
  "message": "Success",
  "body": [
    {
      "id": 1,
      "title": "Mummy",
      "overview": "The best movie",
      "duration": 300,
      "rating": 4,
      "movieDirector": {
        "id": 1,
        "name": "Donald",
        "middleName": "Emeka",
        "surname": "Achugo"
      }
    },
    {
      "id": 2,
      "title": "Mask",
      "overview": "The second best movie",
      "duration": 230,
      "rating": 3,
      "movieDirector": {
        "id": 1,
        "name": "Donald",
        "middleName": "Emeka",
        "surname": "Achugo"
      }
    }
  ]
}

Exception Cases

Status Code 400 BAD REQUEST

{
  "status": "BAD_REQUEST",
  "message": "Rating must be greater than 0 and less than 6",
  "body": null
}

Status Code 404 NOT FOUND

{
  "status": "NOT_FOUND",
  "message": "No movie found",
  "body": null
}

GET /movies/searchByMovieDirector?movieDirectorId={}

Fetch Movies by movieDirectorId

{
  "status": "OK",
  "message": "Success",
  "body": [
    {
      "id": 1,
      "title": "Mummy",
      "overview": "The best movie",
      "duration": 300,
      "rating": 4,
      "movieDirector": {
        "id": 1,
        "name": "Donald",
        "middleName": "Emeka",
        "surname": "Achugo"
      }
    },
    {
      "id": 2,
      "title": "Mask",
      "overview": "The second best movie",
      "duration": 230,
      "rating": 3,
      "movieDirector": {
        "id": 1,
        "name": "Donald",
        "middleName": "Emeka",
        "surname": "Achugo"
      }
    }
  ]
}

Exception Cases

Status Code 404 NOT FOUND

{
  "status": "NOT_FOUND",
  "message": "No Movie Director found",
  "body": null
}

Status Code 404 NOT FOUND

{
  "status": "NOT_FOUND",
  "message": "The Movie Director has directed no movie yet",
  "body": null
}

Movie Director Endpoints

GET /movies/directors/all

Fetch all movies directors present on the system

Respone Body example

{
  "status": "OK",
  "message": "Success",
  "body": [
    {
      "id": 1,
      "name": "Donald",
      "middleName": "Emeka",
      "surname": "Achugo"
    },
    {
      "id": 2,
      "name": "Donald",
      "middleName": null,
      "surname": "Trump"
    }
  ]
}

or

{
  "status": "OK",
  "message": "Success",
  "body": []
}

GET /movies/directors?movieDirectorId={}

Fetch a movie director by movieDirectorId

Respone Body example

{
  "status": "OK",
  "message": "Success",
  "body": {
    "id": 1,
    "name": "Donald",
    "middleName": "Emeka",
    "surname": "Achugo"
  }
}

Exception Cases

Status Code 404 NOT FOUND

{
  "status": "NOT_FOUND",
  "message": "No Movie Director found",
  "body": null
}

POST /movies/directors

Add a Movie Direcotor into the catolog

Request Body example

{
  "name": "Donald",
  "middleName": "Emeka",
  "surname": "Achugo"
}

Response Body example

{
  "status": "CREATED",
  "message": "Success",
  "body": {
    "id": 3,
    "name": "Donald",
    "middleName": "Emeka",
    "surname": "Achugo"
  }
}

PUT /movies/directors

Update a Movie Director

Request Body example

{
  "id": 3,
  "name": "Tommy"
}

or

{
  "id": 3,
  "name": "Tommy",
  "surname": "Smith"
}

Response Body example

{
  "status": "OK",
  "message": "Success",
  "body": {
    "id": 3,
    "name": "Tommy",
    "middleName": "Emeka",
    "surname": "Achugo"
  }
}

or

{
  "status": "OK",
  "message": "Success",
  "body": {
    "id": 3,
    "name": "Tommy",
    "middleName": "Emeka",
    "surname": "Smith"
  }
}

Exception Cases

Status Code 400 BAD REQUEST

{
  "status": "BAD REQUEST",
  "message": "No arguments provided",
  "body": null
}

Status Code 404 NOT FOUND

{
  "status": "NOT_FOUND",
  "message": "No Movie Director found",
  "body": null
}

DELETE /movies/directors?movieDirectorId={}

Remove a Movie Director by movieDirectorId

Exception Cases

Status Code 404 NOT FOUND

{
  "status": "NOT_FOUND",
  "message": "No Movie Director found",
  "body": null
}

⛏️ Built Using

✍️ Authors

@DonNya88 - Initial work

Name		Name	Last commit message	Last commit date
Latest commit History 226 Commits
.github		.github
src		src
test		test
.all-shieldsrc		.all-shieldsrc
.dockerignore		.dockerignore
.eslintrc.js		.eslintrc.js
.gitignore		.gitignore
.nvmrc		.nvmrc
.prettierrc		.prettierrc
.travis.yml		.travis.yml
CHANGELOG.md		CHANGELOG.md
CODEOWNERS		CODEOWNERS
Dockerfile		Dockerfile
LICENCE		LICENCE
MovieCatolg-ER-Diagram.png		MovieCatolg-ER-Diagram.png
README.md		README.md
TODO.md		TODO.md
commitlint.config.js		commitlint.config.js
docker-compose.yaml		docker-compose.yaml
nest-cli.json		nest-cli.json
package.json		package.json
tsconfig.build.json		tsconfig.build.json
tsconfig.json		tsconfig.json
yarn.lock		yarn.lock

License

DonNy88/nestjs-movie-catolg

Folders and files

Latest commit

History

Repository files navigation

Movie Catalog Api

📝 Table of Contents

🏁 Getting Started

Prerequisites

🚀 Deployment

🎈 Usage

🔧 Running the tests

ER Diagram

Api Calls

Movie Endpoints

GET /movies/all

Respone Body example

GET /movies?movieId={}

Respone Body example

Exception Cases

Status Code 404 NOT FOUND

POST /movies

Request Body example

Response Body example

Exception Cases

Status Code 404 NOT FOUND

PUT /movies

Request Body example

Response Body example

Exception Cases

Status Code 400 BAD REQUEST

Status Code 404 NOT FOUND

Status Code 404 NOT FOUND

DELETE /movies?movieId={}

Exception Cases

Status Code 404 NOT FOUND

GET /movies/searchByRating?aboveRating={}

Response Body example

Exception Cases

Status Code 400 BAD REQUEST

Status Code 404 NOT FOUND

GET /movies/searchByMovieDirector?movieDirectorId={}

Exception Cases

Status Code 404 NOT FOUND

Status Code 404 NOT FOUND

Movie Director Endpoints

GET /movies/directors/all

Respone Body example

GET /movies/directors?movieDirectorId={}

Respone Body example

Exception Cases

Status Code 404 NOT FOUND

POST /movies/directors

Request Body example

Response Body example

PUT /movies/directors

Request Body example

Response Body example

Exception Cases

Status Code 400 BAD REQUEST

Status Code 404 NOT FOUND

DELETE /movies/directors?movieDirectorId={}

Exception Cases

Status Code 404 NOT FOUND

⛏️ Built Using

✍️ Authors

About

Topics

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Contributors 3

Languages

Packages