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 Eventos Urbanos API allows you to create, read, update, and delete urban event records in the Cinefinder system.

​
Get All Urban Events

curl -X GET http://localhost:8080/eventosUrbanos
Retrieves a list of all urban events in the system.

​
Response

​
[]
array
Array of urban event objects

​
Response Example

[
  {
    "id": 1,
    "titulo": "Festival de Jazz",
    "descripcion": "Festival de jazz al aire libre",
    "fecha": "2026-06-15T00:00:00.000+00:00",
    "lugar": "Parque Central",
    "categoria_id": 4
  }
]

​
Get Urban Event by Title

curl -X GET http://localhost:8080/eventosUrbanos/{titulo}
Retrieves a specific urban event by its title.

​
Path Parameters

​
titulo
string
required
The title of the urban event to retrieve

​
Response

​
id
integer
Unique identifier for the urban event
​
titulo
string
Title of the urban event
​
descripcion
string
Description of the urban event
​
fecha
string
Date of the event in ISO format
​
lugar
string
Location where the event takes place
​
categoria_id
integer
ID of the category this event belongs to

​
Response Example

{
  "id": 1,
  "titulo": "Festival de Jazz",
  "descripcion": "Festival de jazz al aire libre",
  "fecha": "2026-06-15T00:00:00.000+00:00",
  "lugar": "Parque Central",
  "categoria_id": 4
}

​
Create Urban Event

curl -X POST http://localhost:8080/eventosUrbanos \
  -H "Content-Type: application/json" \
  -d '{
    "titulo": "Concierto Rock",
    "descripcion": "Concierto de rock en vivo",
    "fecha": "2026-07-20T00:00:00.000+00:00",
    "lugar": "Estadio Municipal",
    "categoria_id": 5
  }'
Creates a new urban event in the system.

​
Request Body

​
titulo
string
required
Title of the urban event
​
descripcion
string
required
Description of the urban event
​
fecha
string
required
Date of the event in ISO format (e.g., “2026-07-20T00:00:00.000+00:00”)
​
lugar
string
required
Location where the event takes place
​
categoria_id
integer
required
ID of the category this event belongs to

​
Response

Returns the created urban event object with HTTP status 201 (Created).
​
id
integer
Unique identifier for the newly created urban event
​
titulo
string
Title of the urban event
​
descripcion
string
Description of the urban event
​
fecha
string
Date of the event in ISO format
​
lugar
string
Location where the event takes place
​
categoria_id
integer
ID of the category this event belongs to

​
Response Example

{
  "id": 2,
  "titulo": "Concierto Rock",
  "descripcion": "Concierto de rock en vivo",
  "fecha": "2026-07-20T00:00:00.000+00:00",
  "lugar": "Estadio Municipal",
  "categoria_id": 5
}

​
Update Urban Event

curl -X PUT http://localhost:8080/eventosUrbanos/{id} \
  -H "Content-Type: application/json" \
  -d '{
    "titulo": "Concierto Rock",
    "descripcion": "Updated description",
    "fecha": "2026-07-20T00:00:00.000+00:00",
    "lugar": "Estadio Municipal",
    "categoria_id": 5
  }'
Updates an existing urban event.

​
Path Parameters

​
id
integer
required
The unique identifier of the urban event to update

​
Request Body

​
titulo
string
required
Title of the urban event
​
descripcion
string
required
Description of the urban event
​
fecha
string
required
Date of the event in ISO format
​
lugar
string
required
Location where the event takes place
​
categoria_id
integer
required
ID of the category this event belongs to

​
Response

Returns the updated urban event object.
​
id
integer
Unique identifier for the urban event
​
titulo
string
Title of the urban event
​
descripcion
string
Description of the urban event
​
fecha
string
Date of the event in ISO format
​
lugar
string
Location where the event takes place
​
categoria_id
integer
ID of the category this event belongs to

​
Delete Urban Event

curl -X DELETE http://localhost:8080/eventosUrbanos/{id}
Deletes an urban event from the system.

​
Path Parameters

​
id
integer
required
The unique identifier of the urban event to delete

​
Response

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

​
Response Example

{
  "type": "Success",
  "code": "200",
  "details": "el evento con el id: 1. fue eliminado correctamente.",
  "location": "/eventosUrbanos/1",
  "timestamp": "2026-03-04T10:30:00"
}