Artists

Everything about Argentine Rock artists

ID: getAllArtists

Get all artists

GET

/api/v1/artists

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

offset

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

Typeinteger

Responses

Content-Type

Use example

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

Samples

Bruno

get {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists
}

headers {
  Content-Type: application/json
}

Bruno

get {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists
}

headers {
  Content-Type: application/json
}

cURL

curl -X GET \
'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists' \
 -H "Content-Type: application/json"

JavaScript

fetch('https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists', {headers:{'Content-Type':'application/json'}})
  .then(response => response.json())
  .then(data => console.log(data));

PHP

<?php
$url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists';
$method = 'GET';
$headers = [
    'Content-Type' => 'application/json',
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import requests

url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists'

headers = {
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)
print(response.json())

ID: createArtist

Add a new artist

POST

/api/v1/artists

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

Authorizations

Request Body

Use example

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"

}

Responses

Created

Content-Type

Use example

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

Bruno

post {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists
}

headers {
  Content-Type: application/json
}

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"
  }
}

Bruno

post {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists
}

headers {
  Content-Type: application/json
}

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"
  }
}

cURL

curl -X POST \
'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists' \
 -H "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"
}'

JavaScript

fetch('https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists', {method:'POST',headers:{'Content-Type':'application/json'},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"}'})
  .then(response => response.json())
  .then(data => console.log(data));

PHP

<?php
$url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists';
$method = 'POST';
$headers = [
    'Content-Type' => 'application/json',
];
$body = json_encode({"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"});

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import requests

url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists'

headers = {
    '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'
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

ID: getArtist

Get an artist

GET

/api/v1/artists/{artistId}

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

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

Responses

Artist Found

Content-Type

Use example

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

Bruno

get {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1
}

headers {
  Content-Type: application/json
}

Bruno

get {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1
}

headers {
  Content-Type: application/json
}

cURL

curl -X GET \
'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1' \
 -H "Content-Type: application/json"

JavaScript

fetch('https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1', {headers:{'Content-Type':'application/json'}})
  .then(response => response.json())
  .then(data => console.log(data));

PHP

<?php
$url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1';
$method = 'GET';
$headers = [
    'Content-Type' => 'application/json',
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import requests

url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1'

headers = {
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)
print(response.json())

ID: updateArtist

Update an artist

PUT

/api/v1/artists/{artistId}

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

Authorizations

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

Request Body

Use example

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"

}

Responses

Content-Type

Use example

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

Bruno

put {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1
}

headers {
  Content-Type: application/json
}

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"
  }
}

Bruno

put {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1
}

headers {
  Content-Type: application/json
}

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"
  }
}

cURL

curl -X PUT \
'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1' \
 -H "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"
}'

JavaScript

fetch('https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1', {method:'PUT',headers:{'Content-Type':'application/json'},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"}'})
  .then(response => response.json())
  .then(data => console.log(data));

PHP

<?php
$url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1';
$method = 'PUT';
$headers = [
    'Content-Type' => 'application/json',
];
$body = json_encode({"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"});

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import requests

url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1'

headers = {
    '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'
}

response = requests.put(url, headers=headers, json=data)
print(response.json())

Deprecated

ID: deleteArtist

Delete an artist

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

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

Responses

Bad Request

Content-Type

Use example

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

Bruno

delete {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1
}

headers {
  Content-Type: application/json
}

Bruno

delete {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1
}

headers {
  Content-Type: application/json
}

cURL

curl -X DELETE \
'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1' \
 -H "Content-Type: application/json"

JavaScript

fetch('https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1', {method:'DELETE',headers:{'Content-Type':'application/json'}})
  .then(response => response.json())
  .then(data => console.log(data));

PHP

<?php
$url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1';
$method = 'DELETE';
$headers = [
    'Content-Type' => 'application/json',
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import requests

url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1'

headers = {
    'Content-Type': 'application/json'
}

response = requests.delete(url, headers=headers)
print(response.json())

ID: getAllAlbums

Get all albums

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

Query Parameters

limit

The number of items to return

Typeinteger

offset

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

Typeinteger

Responses

Content-Type

Use example

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

Bruno

get {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums
}

headers {
  Content-Type: application/json
}

Bruno

get {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums
}

headers {
  Content-Type: application/json
}

cURL

curl -X GET \
'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums' \
 -H "Content-Type: application/json"

JavaScript

fetch('https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums', {headers:{'Content-Type':'application/json'}})
  .then(response => response.json())
  .then(data => console.log(data));

PHP

<?php
$url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums';
$method = 'GET';
$headers = [
    'Content-Type' => 'application/json',
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import requests

url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums'

headers = {
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)
print(response.json())

ID: createAlbum

Add a new album

POST

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

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

Authorizations

Parameters

Path Parameters

artistId*

Typeinteger

Required

Example1

Request Body

Use example

JSON

{

"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

Use example

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

Bruno

post {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums
}

headers {
  Content-Type: application/json
}

body {
  {
    "id": 1,
    "name": "La Máquina de Hacer Pájaros",
    "year": 1976,
    "image": "https://cdn.rock-legends.com/photos/la-maquina.jpg"
  }
}

Bruno

post {
  url: https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums
}

headers {
  Content-Type: application/json
}

body {
  {
    "id": 1,
    "name": "La Máquina de Hacer Pájaros",
    "year": 1976,
    "image": "https://cdn.rock-legends.com/photos/la-maquina.jpg"
  }
}

cURL

curl -X POST \
'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums' \
 -H "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"
}'

JavaScript

fetch('https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums', {method:'POST',headers:{'Content-Type':'application/json'},body:'{"id":1,"name":"La Máquina de Hacer Pájaros","year":1976,"image":"https://cdn.rock-legends.com/photos/la-maquina.jpg"}'})
  .then(response => response.json())
  .then(data => console.log(data));

PHP

<?php
$url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums';
$method = 'POST';
$headers = [
    'Content-Type' => 'application/json',
];
$body = json_encode({"id":1,"name":"La Máquina de Hacer Pájaros","year":1976,"image":"https://cdn.rock-legends.com/photos/la-maquina.jpg"});

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python

import requests

url = 'https://stoplight.io/mocks/enzonotario/argentine-rock/122547792/api/v1/artists/1/albums'

headers = {
    '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'
}

response = requests.post(url, headers=headers, json=data)
print(response.json())

Artists​

Get all artists​

Parameters​

Query Parameters

Responses​

Samples​

Add a new artist​

Authorizations​

Request Body​

Responses​

Samples​

Get an artist​

Parameters​

Path Parameters

Responses​

Samples​

Update an artist​

Authorizations​

Parameters​

Path Parameters

Request Body​

Responses​

Samples​

Delete an artist​

Authorizations​

Parameters​

Path Parameters

Responses​

Samples​

Get all albums​

Parameters​

Path Parameters

Query Parameters

Responses​

Samples​

Add a new album​

Authorizations​

Parameters​

Path Parameters

Request Body​

Responses​

Samples​

Artists

Get all artists

Parameters

Responses

Samples

Add a new artist

Authorizations

Request Body

Responses

Samples

Get an artist

Parameters

Responses

Samples

Update an artist

Authorizations

Parameters

Request Body

Responses

Samples

Delete an artist

Authorizations

Parameters

Responses

Samples

Get all albums

Parameters

Responses

Samples

Add a new album

Authorizations

Parameters

Request Body

Responses

Samples