SpotifyWebApi - Core

A .net Core wrapper for the Spotify Web Api.

Nuget package

Installing the package is easy.

Using the package manager console:

PM> Install-Package SpotifyWebApi-Core

Using the dotnet CLI:

> dotnet add package SpotifyWebApi-Core

Getting an authentication token

Client credentials:

var token = ClientCredentials.GetToken(new AuthParameters
{
    ClientId = "clientId",
    ClientSecret = "clientSecret",
    Scopes = Scope.All,
});

Note: A client credentials token cannot access any personal data.
The Token class has a usefull property to check this: token.CanAccessPersonalData

Authorization code:

Start the authorization code process by retrieving the authentication url:

var state = Guid.NewGuid().ToString(); // Save this state because you must check it later

var parameters = new AuthParameters
{
    ClientId = "clientId",
    ClientSecret = "clientSecret",
    RedirectUri = "https://.../callback",
    Scopes = Scope.All,
    ShowDialog = true
};

var url = AuthorizationCode.GetUrl(parameters, state);

At this point you should start a webserver listening on the RedirectUri and the the client/user should login to Spotify.
The webserver should expect the following query parameters: ?code=code&state=state&error=error

// The retreived callback:
var retrievedState = "retrievedState";
var retrievedCode = "code";
var retreivedError = "";

if (state != retrievedState)
{
    throw new Exception("State did not match!");
}

var token = AuthorizationCode.ProcessCallback(parameters, retrievedCode, retreivedError);

// Use the api with access to personal data.
var api = new SpotifyWebApi(token);
var me = await api.UserProfile.GetMe();

A token received with the AuthorizationCode can also be refreshed:

// Refresh a token when its expired
if (token.IsExpired)
{
    token = AuthorizationCode.RefreshToken(parameters, token);
}

Using the api

After a token has been retrieved, we can use the api:

Getting a playlist and the playlist tracks:

ISpotifyWebApi api = new SpotifyWebApi(token);

var playlist = await spotify.Playlist.GetPlaylist(id);
var tracks = await spotify.Playlist.GetPlaylistTracks(id);

TODO:

• Add documentation
• Add api examples
• Implement more endpoints