Spotify Wrapper

A uma aplicação que utiliza a Spotify Web API

Suporte aos Browsers

Essa biblioteca utiliza o Fetch API. E esta API é suportada nos seguintes browsers.

39+ ✔	42+ ✔	29+ ✔	10.1+ ✔	Nope ✘

Dependências

Essa biblioteca depende do fetch para fazer requisições na API Spotify. Para ambientes que não suportam a tecnologia fetch, você precisa prover um polyfill para o navegador ou polyfill para o Node.

Instalação

$ npm install js-spotify-wrapper --save

Como utilizar

ES6

// para importar a biblioteca
import SpotifyWrapper from 'js-spotify-wrapper';

CommonJS

var spotifyWrapper = require('js-spotify-wrapper');

UMD in Browser

<!-- para importar a versão não-minificada -->
<script src="spotify-wrapper.umd.js"></script>

<!-- para importar a versão minificada -->
<script src="spotify-wrapper.umd.min.js"></script>

Após isto, a API ficará disponível pelo nome de SpotifyWrapper. Para utilizar a API é necessário um token que pode ser gerado aqui. O token expira a cada duas horas. Como mostra o exemplo:

const spotify = new SpotifyWrapper({
  token: 'Seu token gerado aqui'
});
const albums = spotify.search.searchAlbums('Artista escolhido');

Metódos

Confira os métodos que a biblioteca disponibiliza

Search

Os metódos search ficam disponíveis pelo atributo 'search'.

const spotify = new SpotifyWrapper({
  token: 'Seu token gerado aqui'
});
const albums = spotify.search.metodoEscolhido();

searchAlbums(query)

Pesquise por albums. Teste em: Spotify Web Console com o tipo definido como album.

Argumentos

Argumento	Tipo	Opções
query	string	'Pesquise qualquer coisa'

Exemplo

searchAlbums('Veil of Maya')
  .then(data => {
    // faça o que quiser com o resultado
  })

searchArtists(query)

Pesquise por artistas. Teste em: Spotify Web Console com o tipo definido como artist.

Argumentos

Argumento	Tipo	Opções
query	string	'Pesquise qualquer coisa'

Exemplo

searchArtists('Veil of Maya')
  .then(data => {
    // faça o que quiser com o resultado
  })

searchTracks(query)

Pesquise por faixas. Teste em: Spotify Web Console com o tipo definido como track.

Argumentos

Argumento	Tipo	Opções
query	string	'Pesquise qualquer coisa'

Exemplo

searchTracks('Veil of Maya')
  .then(data => {
    // faça o que quiser com o resultado
  })

searchPlaylists(query)

Pesquise por playlists. Teste em: Spotify Web Console com o tipo definido como playlist.

Argumentos

Argumento	Tipo	Opções
query	string	'Pesquise qualquer coisa'

Exemplo

searchPlaylists('Veil of Maya')
  .then(data => {
    // faça o que quiser com o resultado
  })

Albums

Os metódos album ficam disponíveis pelo atributo 'album'.

const spotify = new SpotifyWrapper({
  token: 'Seu token gerado aqui'
});
const albums = spotify.album.metodoEscolhido();

getAlbum(id)

Retorne um album específico informando o id. Teste em: Spotify Web Console.

Argumentos

Argumento	Tipo	Opções
id	string	'Id específico'

Exemplo

getAlbum('4aawyAB9vmqN3uQ7FjRGTy')
  .then(data => {
    // faça o que quiser com resultado
  })

getAlbums(ids)

Retorne vários albums específicos informando seus id's Teste em: Spotify Web Console.

Argumentos

Argumento	Tipo	Opções
ids	Array de Strings	['id1', 'id2']

Exemplo

getAlbum(['4aawyAB9vmqN3uQ7FjRGTy', '1A2GTWGtFfWp7KSQTwWOyo'])
  .then(data => {
    // faça o que quiser com o resultado
  })

getAlbumTracks(id)

Retorne a faixas de um album específico informando o id. Teste em: Spotify Web Console.

Argumentos

Argumento	Tipo	Opções
id	string	'Id específico'

Exemplo

getAlbum('4aawyAB9vmqN3uQ7FjRGTy')
  .then(data => {
    // faça o que quiser com o resultado
  })

Artists

Os metódos de artist ficam disponíveis pelo atributo 'artist'.

const spotify = new SpotifyWrapper({
  token: 'Seu token gerado aqui'
});
const artists = spotify.artist.metodoEscolhido();

getArtist(id)

Retorne um artista específico informando o id. Teste em: Spotify Web Console.

Argumentos

Argumento	Tipo	Opções
id	string	'Id específico'

Exemplo

getArtist('0TnOYISbd1XYRBk9myaseg')
  .then(data => {
    // faça o que quiser com resultado
  })

getArtists(ids)

Retorne vários artistas específicos informando seus id's. Teste em: Spotify Web Console.

Argumentos

Argumento	Tipo	Opções
ids	Array de Strings	['id1', 'id2']

Exemplo

getArtists(['2CIMQHirSU0MQqyYHq0eOx','57dN52uHvrHOxijzpIgu3E','1vCWHaC5f2uS3yhpwWbIA6'])
  .then(data => {
    // faça o que quiser com o resultado
  })

getArtistAlbums(id, tipo)

Retorne todos os albums de um determinado artista informando o id. É possível escolher o tipo de album que deseja receber. Teste em: Spotify Web Console.

Argumentos

Argumento	Tipo	Opções
id	string	'Id específico'
tipo	string	'Tipo de dado (single, album, appears_on, compilation)'

Exemplo

getArtistAlbums('0TnOYISbd1XYRBk9myaseg', 'single')
  .then(data => {
    // faça o que quiser com resultado
  })

getArtistTopTracks(id)

Retorne o top 10 de um determinado artista informando o id. Teste em: Spotify Web Console.

Argumentos

Argumento	Tipo	Opções
id	string	'Id específico'

Exemplo

getArtistTopTracks('0TnOYISbd1XYRBk9myaseg')
  .then(data => {
    // faça o que quiser com resultado
  })

getArtistRelated(id)

Retorne os artistas relacionados. Teste em: Spotify Web Console.

Argumentos

Argumento	Tipo	Opções
id	string	'Id específico'

Exemplo

getArtistRelated('0TnOYISbd1XYRBk9myaseg')
  .then(data => {
    // faça o que quiser com resultado
  })

Contribuições

Por favor leia CONTRIBUTING.md para detalhes sobre nosso código de conduta.

Versionamento

Nós usamos SemVer para o versionamento. Para ver as versões disponíveis, visite as tags deste repositorio.

Autores

Darlan Caruso

Veja também a lista de contribuidores que participaram deste projeto.

Licença

Este projeto foi licenciado sobre o MIT - veja o arquivo LICENSE.md para mais detalhes.