vladNed / LatestMovies.API

Project of displaying latest movies and actors movies

LatestMovies.API

This project is an API with 3 functional endpoints:

• Hello World
• Latest Movies
• Movies for a set of actors

How to run ?

There are two main requirements for this project ro run:

• install python >= 3.6
• install flask

There is a requirement.txt file within the project but will not install python and pip

After installing python and pip you can go inside a cmd or bash and run the following commands inside the repo:

$ pip install requirements.txt
$ python startup.py

Endpoints

The app is hosted on google cloud and the URL is: https://circle-citrus.appspot.com

There are 3 endpoints for this API:

• GET /api/v1/hello-world will only display a message hello world
• GET /api/v1/movies/latest will return a json with the latest movies from the current year
• POST /api/v1/movies/actors-movies requires a JSON body with a string list. For example:

{
  "actors_list": ["adam driver","tom ford","vlad nedelcu"]
}

Examples

From a bash console:

• GET /api/v1/hello-world

 $ curl https://circle-citrus.appspot.com/api/v1/hello

• GET /api/v1/movies/latest

 $ curl https://circle-citrus.appspot.com/api/v1/movies/latest

-POST /api/v1/movies/actors-movies -> it will return a JSON for actors Brad Pitt, Johnny Depp and Tom Ford

$ curl --request POST -H "Content-type: application/json" \
          -d '{"actors_list":["brad pitt","johnny depp","tom ford"]}' \
          https://circle-citrus.appspot.com/api/v1/movies/actors-movies

This will return a JSON with 10 movies for each actor sorted from the latest to the earliest.

Configuration

There is a development config for now class inside the app's init:

class DevelopmentConfig(object):
    
    def __init__(self):
        self.DEBUG = True
        self.API_KEY = os.environ.get('API_KEY')
        self.ENV = 'Development'
        self.URL_PREFIX = '/api/v1'
        self.BASE_URL = 'https://api.themoviedb.org'