Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Cinema 3 - (Extremely Simplified) Example of Microservices in Python


Cinema 3 is an example project which demonstrates the use of microservices for a fictional movie theater. The Cinema 3 backend is powered by 4 microservices, all of which happen to be written in Python using Flask.

  • Movie Service: Provides information like movie ratings, title, etc.
  • Show Times Service: Provides show times information.
  • Booking Service: Provides booking information.
  • Users Service: Provides movie suggestions for users by communicating with other services.


Install docker-compose for your platform.

Starting and Stopping Services

Run docker-compose up

APIs and Documentation

Movie Service (port 5001)

This service is used to get information about a movie. It provides the movie title, rating on a 1-10 scale, director and other information.

To lookup all movies in the database, hit:

GET /movies
Returns a list of all movies.

    "267eedb8-0f5d-42d5-8f43-72426b9fb3e6": {
        "director": "Ryan Coogler",
        "id": "267eedb8-0f5d-42d5-8f43-72426b9fb3e6",
        "rating": 8.8,
        "title": "Creed"
...... output truncated ......

To lookup a movie by its id:

GET /movies/7daf7208-be4d-4944-a3ae-c1c2f516f3e6
Returns the specified movie.

    "director": "Paul McGuigan",
    "id": "7daf7208-be4d-4944-a3ae-c1c2f516f3e6",
    "rating": 6.4,
    "title": "Victor Frankenstein",
    "uri": "/movies/7daf7208-be4d-4944-a3ae-c1c2f516f3e6"

Showtimes Service (port 5002)

This service is used get a list of movies playing on a certain date.

To lookup all showtimes, hit:

GET /showtimes
Returns a list of all showtimes by date.

"20151130": [
...... output truncated ......

To get movies playing on a certain date:

GET /showtimes/20151201
Returns all movies playing on the date.


Booking Service (port 5003)

Used to lookup booking information for users.

To get all bookings by all users in the system, hit:

GET /bookings
Returns a list of booking information for all bookings in the database.

    "chris_rivers": {
        "20151201": [
    ...... output truncated ......

To lookup booking information for a user:

GET /bookings/dwight_schrute

        "20151201": [
        "20151205": [

User Service (port 5000)

This service returns information about the users of Cinema 3 and also provides movie suggestions to the users. It communicates with other services to retrieve booking or movie information.

To get a list of all the users in the system, hit:

GET /users
Returns a list of all users in the database.

    "chris_rivers": {
        "id": "chris_rivers",
        "last_active": 1360031010,
        "name": "Chris Rivers"
    ...... output truncated ......

To lookup information about a user:

GET /users/michael_scott
    "id": "michael_scott",
    "last_active": 1360031625,
    "name": "Michael Scott"

To get suggested movies for a user:

GET /users/michael_scott/suggested


No description, website, or topics provided.



No releases published


No packages published