Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Gabo-gutierrez/Cinefinder/llms.txt

Use this file to discover all available pages before exploring further.

Cinefinder API Documentation

Build powerful cinema management applications with our RESTful API for movies, theater works, urban events, and artist tracking.

Get StartedExplore API Reference

Quick start

Get up and running with the Cinefinder API in minutes

1

Set up your environment

Ensure you have Java 21 and Maven installed. Clone the repository and configure your MySQL database connection in application.properties.
git clone https://github.com/Gabo-gutierrez/Cinefinder.git
cd Cinefinder
2

Configure the database

Create the MySQL database using the provided SQL script:
mysql -u root -p < BD_CINES.sql
Update your src/main/resources/application.properties with your database credentials:
spring.datasource.url=jdbc:mysql://localhost:3306/CINES
spring.datasource.username=your_username
spring.datasource.password=your_password
3

Start the application

Build and run the Spring Boot application:
./mvnw spring-boot:run
The API will be available at http://localhost:8080
4

Make your first API call

Retrieve all movies from the catalog:
cURL
curl http://localhost:8080/peliculas

[
  {
    "id": 1,
    "titulo": "El Último Viaje",
    "sipnosis": "Una odisea espacial más allá del sistema solar",
    "duracion": 120,
    "categorias_id": {
      "id": 5,
      "nombre": "Ciencia Ficción"
    }
  }
]

Explore the API

Comprehensive endpoints for managing your cinema content

Movies

Manage your movie catalog with full CRUD operations

Theater Works

Create and manage theatrical performances and works

Urban Events

Track urban cultural events and festivals

Artists

Maintain artist profiles and biographical information

Categories

Organize content with flexible category management

Participations

Link artists to movies, works, and events

Core features

Everything you need to build a comprehensive cinema management system

RESTful Architecture

Clean, predictable API design following REST best practices with standard HTTP methods and status codes.

Spring Boot Framework

Built on Spring Boot 3.5.5 with Java 21, providing enterprise-grade reliability and performance.

JPA Data Persistence

Seamless MySQL integration with Spring Data JPA for efficient database operations and relationship management.

Comprehensive Error Handling

Custom exception hierarchy with global error handling for clear, actionable error responses.

Resources

Additional resources to help you succeed

Architecture Overview

Understand the system design and component architecture

Database Schema

Explore the data model and entity relationships

Error Handling

Learn how to handle exceptions and error responses

Validation

Implement robust input validation for your requests

Ready to get started?

Follow our quickstart guide to have your first API call running in under 5 minutes.

Get Started Now

Build docs developers (and LLMs) love

Get started for freeTalk to us