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

​
Get All Artists

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

​
Response

​
[]
array
Array of artist objects

​
Response Example

[
  {
    "dni": 12345678,
    "nombre": "Pedro",
    "apellido": "Almodóvar",
    "tipo": "Director",
    "descripcion": "Renowned Spanish film director"
  }
]

​
Get Artist by DNI

curl -X GET http://localhost:8080/artistas/{dni}
Retrieves a specific artist by their DNI (identification number).

​
Path Parameters

​
dni
long
required
The DNI (identification number) of the artist to retrieve

​
Response

​
dni
long
Unique identifier (DNI) for the artist
​
nombre
string
First name of the artist
​
apellido
string
Last name of the artist
​
tipo
string
Type or category of the artist
​
descripcion
string
Description or biography of the artist

​
Response Example

{
  "dni": 12345678,
  "nombre": "Pedro",
  "apellido": "Almodóvar",
  "tipo": "Director",
  "descripcion": "Renowned Spanish film director"
}

​
Create Artist

curl -X POST http://localhost:8080/artistas \
  -H "Content-Type: application/json" \
  -d '{
    "dni": 87654321,
    "nombre": "Penélope",
    "apellido": "Cruz",
    "tipo": "Actress",
    "descripcion": "Award-winning Spanish actress"
  }'
Creates a new artist in the system.

​
Request Body

​
dni
long
required
Unique identifier (DNI) for the artist
​
nombre
string
required
First name of the artist
​
apellido
string
required
Last name of the artist
​
tipo
string
required
Type or category of the artist (e.g., actor, director, musician)
​
descripcion
string
required
Description or biography of the artist

​
Response

Returns the created artist object with HTTP status 201 (Created).
​
dni
long
Unique identifier (DNI) for the artist
​
nombre
string
First name of the artist
​
apellido
string
Last name of the artist
​
tipo
string
Type or category of the artist
​
descripcion
string
Description or biography of the artist

​
Response Example

{
  "dni": 87654321,
  "nombre": "Penélope",
  "apellido": "Cruz",
  "tipo": "Actress",
  "descripcion": "Award-winning Spanish actress"
}

​
Update Artist

curl -X PUT http://localhost:8080/artistas/{dni} \
  -H "Content-Type: application/json" \
  -d '{
    "dni": 87654321,
    "nombre": "Penélope",
    "apellido": "Cruz",
    "tipo": "Actress",
    "descripcion": "Updated description"
  }'
Updates an existing artist.

​
Path Parameters

​
dni
long
required
The DNI (identification number) of the artist to update

​
Request Body

​
dni
long
required
Unique identifier (DNI) for the artist
​
nombre
string
required
First name of the artist
​
apellido
string
required
Last name of the artist
​
tipo
string
required
Type or category of the artist
​
descripcion
string
required
Description or biography of the artist

​
Response

Returns the updated artist object.
​
dni
long
Unique identifier (DNI) for the artist
​
nombre
string
First name of the artist
​
apellido
string
Last name of the artist
​
tipo
string
Type or category of the artist
​
descripcion
string
Description or biography of the artist

​
Delete Artist

curl -X DELETE http://localhost:8080/artistas/{dni}
Deletes an artist from the system.

​
Path Parameters

​
dni
long
required
The DNI (identification number) of the artist to delete

​
Response

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

​
Response Example

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

Build docs developers (and LLMs) love

Get started for freeTalk to us