My Portfolio

My Projects

EduFlow

Online Learning Platform

A modern SaaS platform for creating and selling online courses with an intuitive interface and powerful features.

Course Creation & Management
Subscription & One-time Payments
Student Progress Tracking
Video Content Hosting
Mobile Responsive

VIEW DEMO LEARN MORE

Snake vs Cats

Classic Snake game with a twist - avoid the cats! Built with HTML5 Canvas and JavaScript.

Play Game

Login Demo

🔐

User Auth System

User Authentication System

Secure user authentication system with JWT, protected routes, and user profiles. Built with Node.js, Express, MongoDB, and React.

✅ User Registration

✅ Secure Login/Logout

✅ JWT Authentication

✅ Protected Routes

✅ User Profiles

Source Code

🎓

EduFlow

Online Learning Platform

EduFlow - Online Learning Platform

A modern SaaS platform for creating and selling online courses with integrated payment processing and student management.

🎯 Course Creation & Management

💳 Subscription & One-time Payments

📊 Student Progress Tracking

🎥 Video Content Hosting

📱 Mobile Responsive

Learn More

🎬

MovieDB API

Public Movie Database

MovieDB API - Public Movie Database

A comprehensive RESTful API for accessing movie information, including details, ratings, cast, and more.

🎬 Access to thousands of movies and TV shows

🔍 Search by title, genre, year, or actor

📊 Get detailed information including cast and ratings

📱 Easy-to-use RESTful endpoints

📚 Comprehensive documentation

GitHub

MovieDB API Documentation

Base URL

                                        https://api.moviedb.example.com/api/v1
                                    

All endpoints are prefixed with /api/v1

🔒 Authentication

All endpoints require authentication using JWT. Include the token in the Authorization header.

Authorization: Bearer <your_jwt_token>

Admin privileges are required for creating, updating, or deleting movies.

🔐 Authentication

All endpoints require authentication using JWT. Include the token in the Authorization header:

{ "email": "user@example.com", "password": "yourpassword" }

🖼️ Image Uploads

Upload movie posters and backdrops using multipart/form-data.

Supported Formats

JPEG (.jpg, .jpeg)
PNG (.png)
WebP (.webp)

File Size Limit

Maximum file size: 5MB per image

Directory Structure

uploads/
  ├── posters/       # Movie posters (1:1.5 aspect ratio recommended)
  └── backdrops/     # Movie backdrops (16:9 aspect ratio recommended)

Endpoints

GET /movies List all movies

Example Request

Query Parameters

page (number) - Page number (default: 1)
limit (number) - Items per page (default: 10, max: 100)
genre (string) - Filter by genre (e.g., 'action', 'drama')
year (number) - Filter by release year
search (string) - Search in title and description
sort (string) - Sort by field (e.g., 'title', 'year', 'rating')
order (string) - Sort order ('asc' or 'desc', default: 'desc')

Example Request

GET /api/v1/movies?page=1&limit=10&genre=drama&year=2020&sort=rating&order=desc

Example Response (200 OK)

{
  "success": true,
  "page": 1,
  "total_pages": 100,
  "total_results": 1000,
  "results": [
    {
      "id": "tt0111161",
      "title": "The Shawshank Redemption",
      "year": 1994,
      "rating": 9.3,
      "genres": ["Drama"],
      "poster": "https://via.placeholder.com/300x450",
      "createdAt": "2023-01-15T10:30:00Z",
      "updatedAt": "2023-01-15T10:30:00Z"
    }
  ]
}

Error Responses

401 Unauthorized

{
  "success": false,
  "error": "No token provided"
}

400 Bad Request

{
  "success": false,
  "error": "Invalid query parameters",
  "details": {
    "year": "Year must be a number"
  }
}

GET /movies/:id Get movie details

Example Request

URL Parameters

id (string) - Movie ID (IMDB ID or internal ID)

Example Request

GET /api/v1/movies/tt0111161

Example Response (200 OK)

{
  "success": true,
  "data": {
    "id": "tt1375666",
    "title": "Inception",
    "year": 2010,
    "rated": "PG-13",
    "released": "2010-07-16",
    "runtime": 148,
    "genres": ["Action", "Adventure", "Sci-Fi"],
    "director": "Christopher Nolan",
    "writer": "Christopher Nolan",
    "actors": ["Leonardo DiCaprio", "Joseph Gordon-Levitt", "Ellen Page"],
    "plot": "A thief who steals corporate secrets through the use of dream-sharing technology is given the inverse task of planting an idea into the mind of a C.E.O., but his tragic past may doom the project and his team to disaster.",
    "language": "English, Japanese, French",
    "country": "United States, United Kingdom",
    "awards": "Won 4 Oscars. 159 wins & 220 nominations total",
    "poster_url": "https://api.moviedb.example.com/uploads/posters/tt1375666.jpg",
    "backdrop_url": "https://api.moviedb.example.com/uploads/backdrops/tt1375666.jpg",
    "ratings": [
      { "source": "Internet Movie Database", "value": "8.8/10" },
      { "source": "Rotten Tomatoes", "value": "87%" },
      { "source": "Metacritic", "value": "74/100" }
    ],
    "metascore": "74",
    "imdb_rating": 8.8,
    "imdb_votes": 2483527,
    "imdb_id": "tt1375666",
    "type": "movie",
    "dvd": "07 Dec 2010",
    "box_office": "$292,576,195",
    "production": "Warner Bros. Pictures, Legendary Pictures, Syncopy",
    "website": "http://inceptionmovie.warnerbros.com/",
    "created_at": "2023-01-15T10:30:00Z",
    "updated_at": "2023-01-15T10:30:00Z"
  }
}

Error Responses

404 Not Found

{
  "success": false,
  "error": "Movie not found"
}

POST /movies Create a new movie with image uploads (Admin only)

Request Headers

Content-Type: multipart/form-data
Authorization: Bearer <your_jwt_token>

Form Data

Field	Description	Type	Required
`title`	Movie title	string	✅
`year`	Release year	integer	✅
`poster`	Movie poster image file (max 5MB)	file (jpg, png, webp)	✅
`backdrop`	Movie backdrop image file (max 5MB)	file (jpg, png, webp)	❌
`director`	Director's name	string	✅
`plot`	Movie plot summary	string	✅
`genres`	Array of genre names (comma-separated)	string	✅
`runtime`	Movie duration in minutes	integer	❌
`actors`	Comma-separated list of actors	string	❌
`imdb_rating`	IMDb rating (0-10)	number	❌

Example Request (cURL)

curl -X POST \
  https://api.moviedb.example.com/api/v1/movies \
  -H 'Authorization: Bearer your_jwt_token_here' \
  -F 'title=Inception' \
  -F 'year=2010' \
  -F 'director=Christopher Nolan' \
  -F 'plot=A thief who steals corporate secrets...' \
  -F 'genres=Action,Sci-Fi,Thriller' \
  -F 'runtime=148' \
  -F 'poster=@/path/to/inception-poster.jpg' \
  -F 'backdrop=@/path/to/inception-backdrop.jpg'

Response (201 Created)

{
  "success": true,
  "data": {
    "id": "tt1375666",
    "title": "Inception",
    "year": 2010,
    "director": "Christopher Nolan",
    "plot": "A thief who steals corporate secrets through the use of dream-sharing technology...""",
    "genres": ["Action", "Sci-Fi", "Thriller"],
    "runtime": 148,
    "actors": ["Leonardo DiCaprio", "Joseph Gordon-Levitt", "Ellen Page"],
    "imdb_rating": 8.8,
    "poster_url": "https://api.moviedb.example.com/uploads/posters/inception_12345.jpg",
    "backdrop_url": "https://api.moviedb.example.com/uploads/backdrops/inception_12345.jpg",
    "created_at": "2023-01-15T10:30:00Z",
    "updated_at": "2023-01-15T10:30:00Z"
  }
}

Error Responses

400 Bad Request - Invalid file type

{
  "success": false,
  "error": "VALIDATION_ERROR",
  "message": "Invalid file type. Only jpg, jpeg, png, webp are allowed.",
  "details": {
    "field": "poster",
    "code": "INVALID_FILE_TYPE"
  }
}

400 Bad Request - File too large

{
  "success": false,
  "error": "VALIDATION_ERROR",
  "message": "File size too large. Maximum size is 5MB.",
  "details": {
    "field": "backdrop",
    "code": "FILE_TOO_LARGE"
  }
}

401 Unauthorized

{
  "success": false,
  "error": "UNAUTHORIZED",
  "message": "Authentication required"
}

403 Forbidden

{
  "success": false,
  "error": "FORBIDDEN",
  "message": "Insufficient permissions to perform this action"
}

PUT /api/v1/movies/:id Update a movie (Admin only)

Request Body (JSON)

{
  "plot": "Updated plot description...",
  "rating": 8.8
}

Example Response (200 OK)

{
  "success": true,
  "data": {
    "id": "tt1375666",
    "title": "Inception",
    "plot": "Updated plot description...",
    "rating": 8.8,
    "updatedAt": "2023-01-16T14:30:00Z"
  }
}

DELETE /api/v1/movies/:id Delete a movie (Admin only)

Example Response (200 OK)

{
  "success": true,
  "message": "Movie deleted successfully"
}

Error Response (403 Forbidden)

{
  "success": false,
  "error": "Admin privileges required"
}

🛠️ Implementation Notes

Backend Setup (Node.js + Express)

1. Install required packages:

npm install express multer jsonwebtoken

2. Configure multer for file uploads:

const multer = require('multer');
const path = require('path');

// Configure storage
const storage = multer.diskStorage({
  destination: function (req, file, cb) {
    let dir = 'uploads/';
    if (file.fieldname === 'poster') {
      dir += 'posters/';
    } else if (file.fieldname === 'backdrop') {
      dir += 'backdrops/';
    }
    require('fs').mkdirSync(dir, { recursive: true });
    cb(null, dir);
  },
  filename: function (req, file, cb) {
    // Use movie ID if available, otherwise generate a unique name
    const movieId = req.params.id || Date.now();
    const ext = path.extname(file.originalname).toLowerCase();
    cb(null, `${movieId}${ext}`);
  }
});

// File filter to accept only images
const fileFilter = (req, file, cb) => {
  const allowedTypes = ['.jpg', '.jpeg', '.png', '.webp'];
  const ext = path.extname(file.originalname).toLowerCase();
  if (allowedTypes.includes(ext)) {
    return cb(null, true);
  }
  cb(new Error('Invalid file type. Only jpg, jpeg, png, webp are allowed.'));
};

// Initialize multer with configuration
const upload = multer({
  storage: storage,
  fileFilter: fileFilter,
  limits: {
    fileSize: 5 * 1024 * 1024, // 5MB limit
    files: 2 // Max 2 files (poster and backdrop)
  }
});

// Middleware for handling file uploads
const uploadMovieImages = upload.fields([
  { name: 'poster', maxCount: 1 },
  { name: 'backdrop', maxCount: 1 }
]);

Example Route Implementation

// Create movie with image uploads
router.post('/movies', authenticateJWT, isAdmin, uploadMovieImages, async (req, res) => {
  try {
    const movieData = req.body;
    
    // Process uploaded files
    if (req.files) {
      if (req.files.poster) {
        movieData.poster_url = `/uploads/posters/${req.files.poster[0].filename}`;
      }
      if (req.files.backdrop) {
        movieData.backdrop_url = `/uploads/backdrops/${req.files.backdrop[0].filename}`;
      }
    }
    
    // Process genres if sent as comma-separated string
    if (typeof movieData.genres === 'string') {
      movieData.genres = movieData.genres.split(',').map(g => g.trim());
    }
    
    // Process actors if sent as comma-separated string
    if (typeof movieData.actors === 'string') {
      movieData.actors = movieData.actors.split(',').map(a => a.trim());
    }
    
    // Create movie in database
    const movie = await Movie.create(movieData);
    
    res.status(201).json({
      success: true,
      data: movie
    });
    
  } catch (error) {
    console.error('Error creating movie:', error);
    res.status(400).json({
      success: false,
      error: 'VALIDATION_ERROR',
      message: error.message
    });
  }
});

Getting Started

To start using the MovieDB API:

Sign up at developer.moviedb.example.com to get your API key
Include the JWT token in the Authorization header of your requests
Use multipart/form-data for file uploads
Start making requests to the API endpoints

For support, contact support@moviedb.example.com

Escolha um Curso

📊

Data Science 101

Aprenda os fundamentos de ciência de dados com Python

⭐ 4.8 (1.2k alunos) 🎓 12 horas

🎨

UI/UX Design Masterclass

Domine os princípios de design de interface e experiência do usuário

⭐ 4.9 (987 alunos) 🎓 8 horas

Hi, I'm Lucas

Full Stack Developer

About Me

I'm a passionate web developer

My Skills

My Expertise

Frontend Development

Backend Development

Database & DevOps

Tools & Others

My Projects

EduFlow

Snake vs Cats

Login Demo

User Auth System

User Authentication System

EduFlow

EduFlow - Online Learning Platform

MovieDB API

MovieDB API - Public Movie Database

Request Headers

Form Data

Example Request (cURL)

Response (201 Created)

Error Responses

Get In Touch

Let's work together

Server Status

Conectando ao servidor...