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.

The Peliculas API allows you to create, read, update, and delete movie records in the Cinefinder system.

​
Get All Movies

curl -X GET http://localhost:8080/peliculas
Retrieves a list of all movies in the system.

​
Response

​
[]
array
Array of movie objects

​
Response Example

[
  {
    "id": 1,
    "titulo": "The Shawshank Redemption",
    "sipnosis": "Two imprisoned men bond over a number of years",
    "duracion": 142,
    "categoria_id": 1
  }
]

​
Get Movie by Title

curl -X GET http://localhost:8080/peliculas/{titulo}
Retrieves a specific movie by its title.

​
Path Parameters

​
titulo
string
required
The title of the movie to retrieve

​
Response

​
id
integer
Unique identifier for the movie
​
titulo
string
Title of the movie
​
sipnosis
string
Synopsis or description of the movie
​
duracion
integer
Duration of the movie in minutes
​
categoria_id
integer
ID of the category this movie belongs to

​
Response Example

{
  "id": 1,
  "titulo": "The Shawshank Redemption",
  "sipnosis": "Two imprisoned men bond over a number of years",
  "duracion": 142,
  "categoria_id": 1
}

​
Create Movie

curl -X POST http://localhost:8080/peliculas \
  -H "Content-Type: application/json" \
  -d '{
    "titulo": "Inception",
    "sipnosis": "A thief who steals corporate secrets",
    "duracion": 148,
    "categoria_id": 2
  }'
Creates a new movie in the system.

​
Request Body

​
titulo
string
required
Title of the movie
​
sipnosis
string
required
Synopsis or description of the movie
​
duracion
integer
required
Duration of the movie in minutes
​
categoria_id
integer
required
ID of the category this movie belongs to

​
Response

Returns the created movie object with HTTP status 201 (Created).
​
id
integer
Unique identifier for the newly created movie
​
titulo
string
Title of the movie
​
sipnosis
string
Synopsis or description of the movie
​
duracion
integer
Duration of the movie in minutes
​
categoria_id
integer
ID of the category this movie belongs to

​
Response Example

{
  "id": 2,
  "titulo": "Inception",
  "sipnosis": "A thief who steals corporate secrets",
  "duracion": 148,
  "categoria_id": 2
}

​
Update Movie

curl -X PUT http://localhost:8080/peliculas/{id} \
  -H "Content-Type: application/json" \
  -d '{
    "titulo": "Inception",
    "sipnosis": "Updated synopsis",
    "duracion": 148,
    "categoria_id": 2
  }'
Updates an existing movie.

​
Path Parameters

​
id
integer
required
The unique identifier of the movie to update

​
Request Body

​
titulo
string
required
Title of the movie
​
sipnosis
string
required
Synopsis or description of the movie
​
duracion
integer
required
Duration of the movie in minutes
​
categoria_id
integer
required
ID of the category this movie belongs to

​
Response

Returns the updated movie object.
​
id
integer
Unique identifier for the movie
​
titulo
string
Title of the movie
​
sipnosis
string
Synopsis or description of the movie
​
duracion
integer
Duration of the movie in minutes
​
categoria_id
integer
ID of the category this movie belongs to

​
Delete Movie

curl -X DELETE http://localhost:8080/peliculas/{id}
Deletes a movie from the system.

​
Path Parameters

​
id
integer
required
The unique identifier of the movie to delete

​
Response

​
type
string
Response type, always “Success”
​
code
string
HTTP status code (200)
​
details
string
Success message with the deleted movie ID
​
location
string
Request URI that was called
​
timestamp
string
Timestamp of the operation

​
Response Example

{
  "type": "Success",
  "code": "200",
  "details": "la pelicula con el id: 1. fue eliminada correctamente.",
  "location": "/peliculas/1",
  "timestamp": "2026-03-04T10:30:00"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us