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 Participaciones API allows you to create, read, update, and delete participation records that link artists to events in the Cinefinder system.

Get All Participations

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

Response

[]
array
Array of participation objects

Response Example

[
  {
    "id": 1,
    "artistas_dni": 12345678,
    "tipo_evento": "pelicula",
    "evento_id": 5
  }
]

Get Participation by Event Type

curl -X GET http://localhost:8080/participaciones/{tipo_evento}
Retrieves a specific participation by event type.

Path Parameters

tipo_evento
string
required
The type of event to filter participations (e.g., “pelicula”, “obra”, “eventoUrbano”)

Response

id
integer
Unique identifier for the participation
artistas_dni
long
DNI of the artist participating in the event
tipo_evento
string
Type of event
evento_id
integer
ID of the event the artist is participating in

Response Example

{
  "id": 1,
  "artistas_dni": 12345678,
  "tipo_evento": "pelicula",
  "evento_id": 5
}

Create Participation

curl -X POST http://localhost:8080/participaciones \
  -H "Content-Type: application/json" \
  -d '{
    "artistas_dni": 87654321,
    "tipo_evento": "obra",
    "evento_id": 12
  }'
Creates a new participation record linking an artist to an event.

Request Body

artistas_dni
long
required
DNI of the artist participating in the event
tipo_evento
string
required
Type of event (e.g., “pelicula”, “obra”, “eventoUrbano”)
evento_id
integer
required
ID of the event the artist is participating in

Response

Returns the created participation object with HTTP status 201 (Created).
id
integer
Unique identifier for the newly created participation
artistas_dni
long
DNI of the artist participating in the event
tipo_evento
string
Type of event
evento_id
integer
ID of the event the artist is participating in

Response Example

{
  "id": 2,
  "artistas_dni": 87654321,
  "tipo_evento": "obra",
  "evento_id": 12
}

Update Participation

curl -X PUT http://localhost:8080/participaciones/{id} \
  -H "Content-Type: application/json" \
  -d '{
    "artistas_dni": 87654321,
    "tipo_evento": "obra",
    "evento_id": 15
  }'
Updates an existing participation record.

Path Parameters

id
integer
required
The unique identifier of the participation to update

Request Body

artistas_dni
long
required
DNI of the artist participating in the event
tipo_evento
string
required
Type of event (e.g., “pelicula”, “obra”, “eventoUrbano”)
evento_id
integer
required
ID of the event the artist is participating in

Response

Returns the updated participation object.
id
integer
Unique identifier for the participation
artistas_dni
long
DNI of the artist participating in the event
tipo_evento
string
Type of event
evento_id
integer
ID of the event the artist is participating in

Delete Participation

curl -X DELETE http://localhost:8080/participaciones/{id}
Deletes a participation record from the system.

Path Parameters

id
integer
required
The unique identifier of the participation to delete

Response

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

Response Example

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

Build docs developers (and LLMs) love