Como usar a API do Grooveshark

A API do Grooveshark oferece dois tipos de acesso:

• Acesso enxuto
• Acesso completo

O acesso enxuto é muito fácil de conseguir e é instantâneo, basta cadastrar seu email que a chave é enviada.

Em um email assim:

"Your new Tinysong API Key.
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

É este que irei utilizar.Para ter o acesso completo, segundo informação contida no site é necessário enviar uma mensagem para a equipe do Grooveshark explicando os objetivos e funcionalidades do seu aplicativo.

Vamos chamar o acesso enxuto, com o mesmo nome dado pela equipe Grooveshark: Tinysong API Key

É muito simples. Possui 3 métodos: a, b e s

O endereço para solicitar a API Key é http://tinysong.com/api

Neste mesmo endereço se encontra a documentação dos três métodos.

Segue o modelo geral para acionar os métodos
http://tinysong.com/method/query?format=json&key=APIKey

/a/

Este método retorna um único link. O Tinysong executa uma busca de música e artista concatenados e retorna o primeiro resultado encontrado.

Exemplo
http://tinysong.com/a/Fernandinho+Vento+Impetuoso?format=json&key=APIKey
Retorno
"http:\/\/tinysong.com\/17i3E"
Se não encontrar a música, retorna um set vazio, [] deste jeito será retornado

/b/
Este método faz a mesma busca do /a/ porém retorna informações adicionais sobre o link.

Exemplo
http://tinysong.com/b/Fernandinho+Vento+Impetuoso?format=json&key=APIKey
Retorno
{
"Url":"http:\/\/tinysong.com\/17i3E",
"SongID":36921568,
"SongName":"Vento Impetuoso",
"ArtistID":655665,
"ArtistName":"Fernandinho",
"AlbumID":8261801,
"AlbumName":"Teus Sonhos"
}

/s/
Este método faz o que os outros métodos fazem, porem exibe resultados multiplos com saída similar ao /b/. Se você deseja limitar o número de resultados, pasta adicionar o parametro 'limit' na url. Valor mínimo um e máximo trinta e dois. O Default é cinco.

Exemplo
http://tinysong.com/s/Beethoven?format=json&limit=3&key=APIKey

Retorno
[

{"Url":"http:\/\/tinysong.com\/17mCG",
"SongID":36921712,
"SongName":"Um Dia Em Tua Casa",
"ArtistID":655665,
"ArtistName":"Fernandinho",
"AlbumID":8261801,
"AlbumName":"Teus Sonhos"},

{"Url":"http:\/\/tinysong.com\/17iy2",
"SongID":36921686,
"SongName":"Mil Cairao",
"ArtistID":655665,
"ArtistName":"Fernandinho",
"AlbumID":8261801,
"AlbumName":"Teus Sonhos"},

{"Url":"http:\/\/tinysong.com\/17mB2",
"SongID":36921658,
"SongName":"Agindo Deus",
"ArtistID":655665,
"ArtistName":"Fernandinho",
"AlbumID":8261801,
"AlbumName":"Teus Sonhos"},

{"Url":"http:\/\/tinysong.com\/17gU2",
"SongID":36921629,
"SongName":"O Hino",
"ArtistID":655665,
"ArtistName":"Fernandinho",
"AlbumID":8261801,
"AlbumName":"Teus Sonhos"}
]

Como observado ó retorno é no formato JSON. É possível utilizar um widget flash para exibir o player em sua aplicação. Em breve colocarei o exemplo.