Documentação: Discografias

Demi Lovato Fall Out Boy

O Vagalume possui também um banco de dados organizando as discografias (álbuns) de cada artista. Como todas as outras chamadas da API, o retorno é feito por JSON e pode e deve ser feito direto pelo navegador do usuário.

Exemplo Javascript

Para que seja possível acessar a API via Javascript a partir do seu domínio, permitimos o acesso de outra origem com o Cross-Origin Resource Sharing (já suportado no Chrome e Firefox). Para os outros navegadores, você também pode utilizar a requisição JSONP passando um parâmetro de callback.

O exemplo abaixo é bem simples e utiliza getJSON do jQuery (sem necessidade de especificar o callback).

// Exemplo de requisição
jQuery.getJSON(
	"https://www.vagalume.com.br/u2/discografia/index.js",
	function (data) {
		// Nome do artista
		alert(data.discography.artist.desc);
	}
);

Onde /u2/ corresponde a URL do artista no Vagalume.

Resposta da consulta em JSON

URL: https://www.vagalume.com.br/u2/discografia/index.js

// Exemplo de retorno da requisição
{
	"discography":{
		"artist":{
			"id":"3ade68b2g3b86eda3",
			"desc":"U2",
			"url":"/u2/"
		},
		"item":
			[
				{
					"id":"3ade68b6g4f38fda3",
					"desc":"No line on the horizon",
					"url":"/u2/discografia/no-line-on-the-horizon.html",
					"cover":"/u2/discografia/no-line-on-the-horizon-W125.jpg",
					"label":"Island/Universal",
					"published":"2009",
					"discs":
						[
							[
								{
									"id":"3ade68b8gfd729fa3",
									"desc":"No Line On The Horizon",
									"url":"/u2/no-line-on-the-horizon.html"
								},{
									"id":"3ade68b8g47c29fa3",
									"desc":"Magnificent",
									"url":"/u2/magnificent.html"
								},{
									"id":"3ade68b8g75b29fa3",
									"desc":"Moment Of Surrender",
									"url":"/u2/moment-of-surrender.html"
								},
								...
							]
							...
						]
				},{
					"id":"3ade68b6ge7e7fda3",
					"desc":"U218 Singles",
					"url":"/u2/discografia/u218-singles.html",
					"cover":"/u2/discografia/u218-singles-W125.jpg",
					"label":"Island/Polygraml",
					"published":"2006",
					"discs":
						[
							[
								{
									"id":"3ade68b2g5b86eda3",
									"desc":"Beautiful Day",
									"url":"/u2/beautiful-day.html"
								},{
									"id":"3ade68b2g9b86eda3",
									"desc":"I Still Haven't Found What I'm Looking For",
									"url":"/u2/i-still-havent-found-what-im-looking-for.html"
								},{
									"id":"3ade68b7gc5ad0ea3",
									"desc":"Pride (In the Name of Love)",
									"url":"/u2/pride-in-the-name-of-love.html"
								},
								...
							]
						]
				},
				...
			]
	}
	
}

As propriedades do objeto JSON de resposta são as seguintes:

discographyContém as informações da discografia:

artistContém informações do artista no Vagalume
descNome do artista idID do artista no Vagalume urlURL da página do artista no Vagalume
itemContém informações dos álbuns
idID do álbum no Vagalume descNome do álbum urlURL do álbum no Vagalume coverURL da imagem da capa do álbum labelGravadora do álbum publishedAno de lançamento do álbum discsContém informações dos discos que compõem o álbum
nameNome do música idID da música no Vagalume urlURL da música no Vagalume