Artists

Everything about Argentine Rock artists

---

ID: getAllArtists

Get all artists

Artists

GET

/api/v1/artists

Serverhttps://localhost:3000https://stoplight.io/mocks/enzonotario/argentine-rock/122547792https://stoplight.io/mocks/enzonotario/argentine-rock/122547792

Get a list of all legendary Argentine Rock artists and explore their contributions to the music scene.

Parameters

Query Parameters

limit

The number of items to return

Typeinteger

Examples

102050

formatint64

default10

offset

The number of items to skip before starting to collect the result set

Typeinteger

Examples

123456

formatint64

default0

Responses

OK

Content-Type

application/json

{

"data": [

{

"id": 1,

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

],

"meta": {

"limit": 10,

"offset": 0,

"total": 100,

"next": "/artists?limit=10&offset=10"

}

}

GET

/api/v1/artists

Serverhttps://localhost:3000https://stoplight.io/mocks/enzonotario/argentine-rock/122547792https://stoplight.io/mocks/enzonotario/argentine-rock/122547792

Samples

---

ID: createArtist

Add a new artist

Artists

POST

/api/v1/artists

Add a new legendary Argentine Rock artist. Make sure they truly deserve the title!

Authorizations

bearerAuth

TypeHTTP (bearer)

or

apiKeyHeader

TypeAPI Key (header: X-API-Key)

Request Body

{

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

Responses

Created

Content-Type

application/json

{

"id": 1,

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

POST

/api/v1/artists

Samples

---

ID: getArtist

Get an artist

Artists

GET

/api/v1/artists/{artistId}

Learn more about a specific Argentine Rock artist and their legacy.

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

formatint64

Responses

Artist Found

Content-Type

application/json

{

"id": 1,

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

GET

/api/v1/artists/{artistId}

Samples

---

ID: updateArtist

Update an artist

Artists

PUT

/api/v1/artists/{artistId}

Update the information of a legendary Argentine Rock artist. Make sure to provide accurate data.

Authorizations

bearerAuth

TypeHTTP (bearer)

or

apiKeyHeader

TypeAPI Key (header: X-API-Key)

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

formatint64

Request Body

{

"id": 1,

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

Responses

OK

Content-Type

application/json

{

"id": 1,

"name": "Charly García",

"description": "One of the most influential rock musicians in Argentine history.",

"image": "https://cdn.rock-legends.com/photos/charly.jpg",

"band": "Sui Generis"

}

PUT

/api/v1/artists/{artistId}

Samples

---

Deprecated

ID: deleteArtist

Delete an artist

Artists

DELETE

/api/v1/artists/{artistId}

This endpoint was used to delete artists. Unfortunately, that caused a lot of controversy. So, this endpoint is now deprecated and should not be used anymore.

Authorizations

bearerAuth

TypeHTTP (bearer)

or

apiKeyHeader

TypeAPI Key (header: X-API-Key)

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

formatint64

Responses

Bad Request

Content-Type

application/json

{

"type": "https://example.com/errors/generic-error",

"title": "Something went wrong here.",

"status": 403,

"detail": "Unfortunately, we can’t provide further information."

}

DELETE

/api/v1/artists/{artistId}

Samples

---

ID: getAllAlbums

Get all albums

Artists

GET

/api/v1/artists/{artistId}/albums

Get a list of all albums from a legendary Argentine Rock artist.

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

formatint64

Query Parameters

limit

The number of items to return

Typeinteger

Examples

102050

formatint64

default10

offset

The number of items to skip before starting to collect the result set

Typeinteger

Examples

123456

formatint64

default0

Responses

OK

Content-Type

application/json

{

"data": [

{

"id": 1,

"name": "La Máquina de Hacer Pájaros",

"year": 1976,

"image": "https://cdn.rock-legends.com/photos/la-maquina.jpg"

}

],

"meta": {

"limit": 10,

"offset": 0,

"total": 100,

"next": "/artists?limit=10&offset=10"

}

}

GET

/api/v1/artists/{artistId}/albums

Samples

---

ID: createAlbum

Add a new album

Artists

POST

/api/v1/artists/{artistId}/albums

Add a new album to a legendary Argentine Rock artist. Make sure it’s a masterpiece!

Authorizations

bearerAuth

TypeHTTP (bearer)

or

apiKeyHeader

TypeAPI Key (header: X-API-Key)

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

formatint64

Request Body

{

"id": 1,

"name": "La Máquina de Hacer Pájaros",

"year": 1976,

"image": "https://cdn.rock-legends.com/photos/la-maquina.jpg"

}

Responses

Created

Content-Type

application/json

{

"id": 1,

"name": "La Máquina de Hacer Pájaros",

"year": 1976,

"image": "https://cdn.rock-legends.com/photos/la-maquina.jpg"

}

POST

/api/v1/artists/{artistId}/albums

Samples

---

Powered by VitePress OpenAPI