Documentação: Imagens

Anitta

O Vagalume possui também um banco de imagens organizadas por galerias. Disponibilizadas pelo próprio artista no caso como (Divulgação) ou as que os prórpios usuários enviam (Enviadas pelos usuários).

Importante

Para usar Vagalume API, é necessário que seu aplicativo tenha credenciais de autorização. Cadastre-se no Vagalume e crie sua chave de API. Esta credencial será requerida a partir do dia 23/11/2015.

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
var artist = "3ade68b3gdb86eda3";
var song   = 10;
jQuery.getJSON(
    "https://api.vagalume.com.br/image.php"
		+ "?bandID=" + artist
		+ "&limit=" + limit
		+ "&apikey={key}",
	function (data) {
		// URL da imagem
		alert(data.images[0].url);
	}
);

Parâmetros de consulta

bandIDID do artista limitLimite de imagens (opcional). Caso oculto retorna 3. Retorno máximo de 10.

Resposta da consulta em JSON

// Exemplo de retorno da requisição
{
	"images":{
			[
				{
					"url":"https://s2.vagalume.com/red-hot-chili-peppers/images/g34178.jpg",
					"width":"400",
					"height":"265",
					"thumbUrl":"https://s2.vagalume.com/red-hot-chili-peppers/images/gt34178.jpg",
					"thumbWidth":"115",
					"thumbHeight":"74"
				},{
					"url":"https://s2.vagalume.com/red-hot-chili-peppers/images/g34177.jpg",
					"width":"400",
					"height":"265",
					"thumbUrl":"https://s2.vagalume.com/red-hot-chili-peppers/images/gt34177.jpg",
					"thumbWidth":"115",
					"thumbHeight":"74"
				},
				...
			]
	}
	
}

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

imagesContém as imagens:
urlURL da imagem widthLargura da imagem heightAltura da imagem thumbUrlURL do thumb da imagem thumbWidthLargura do thumb da imagem thumbHeightAltura do thumb da imagem