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.