SpotifyAPI NET Versions Save

➕ Additions

• Add HtmlDescription to all shows/episodes ( #944 )
• Add TotalEpisodes to all shows
• Add support for .NET 8.0
• [Add Users Top Tracks / Users Top Artists to UserClient ( #938, thanks to @Noelg14 )

🏗️ Fixes

• Fixed a case where spotify returns doubles instead of ints ( #942, thanks to @Lewis-Fam )

Miscellaneous

• Updated dependencies

➕ Additions

• Re-add .net-standard 2.0 support
• Cancellation token in SpotifyClient::PaginateAll for passing to Paginator (#907)

Miscellaneous

• Updated dependencies
• Remove SimplePlaylist as it was unused, should be replaced by FullPlaylist
• Replace port 5000 (often used) of the examples with 5543

➕ Additions

• Adding Endpoint to get a User's Queue (thanks to @gavinsteinhoff #807)
• Added .NET 7 support
• All API calls now have an optional CancellationToken parameter, which can be used to prematurely cancel the request (Thanks to @esskar #813 )
• The RemoveLibrary endpoints silently stopped accepting ids in the body paremter, so we moved them to the query parameters
• PlaylistGetRequest and PlaylistGetItemRequest now use List for the type of the fields value. We can now use AddRangeetc. to add multiple entries at once

Miscellaneous

• Updated dependencies

Breaking Changes

All API Endpoint calls have a new CancellationToken parameter, which is optional however. Thus, the type signatures of the methods have changed.

➕ Additions

• Added MarketsClient (Thanks to @esskar #787 )

Miscellaneous

• Updated to .net 6.0 and remove .net-standard2.0 support
• Updated dependencies
• Abort example if env variables are not set

🏗 Fixes

• Added RefreshToken to AuthorizationCodeRefreshResponse

Miscellaneous

• Bumped dependencies

🏗 Fixes

• All types based on IPlayableItem can now correctly be serialized/deserialized, #604
• Added all episode library functions, #608
• Added TrackMeta and TrackAudio in TrackAudioAnalysis, #648

Miscellaneous

• Bumped dependencies

➕ Additions

• Added ErrorReceived event to the auth server of SpotifyAPI.Web.Auth. An example can be found in the docs

🏗 Fixes:

• Add TotalTracks to SimpleAlbum.cs and FullAlbum.cs (#597)
• PlayHistoryItem SimpleTrack --> FullTrack (#524)

Miscellaneous

• Bumped dependencies

➕ Additions

• Added NextPage and PreviousPage.

var browse = await spotify.Browse.GetCategoryPlaylists("at_home", new CategoriesPlaylistsRequest { Limit = 10 });
var browse2 = await spotify.NextPage(browse.Playlists);

🏗 Fixes:

• Fixed query/body params An item with the same key has already been added. Key: limit (#567 )
• Paginate methods were only available in .NET Standard 2.1. It's now available for all versions > .NET Standard 2.1 (e.g .NET 5)

🎉 The initial, stable release of SpotifyAPI.Web and SpotifyAPI.Web.Auth Version 6! 🎉

Thank you for all reports in the beta phase 😊. The last beta release was about 3 months ago and it's time to hit stable!

Overall Features of V6

• ✅ Typed responses and requests to over 74 endpoints. Complete and always up to date.
• ✅ Supports .NET 5.0 and .NET Standard 2.X, which includes all major platforms, including mobile:
  • .NET Framework
  • UWP
  • .NET Core
  • Xamarin.Forms
• ✅ Included HTTPClient, but feel free to bring your own!
• ✅ Logging supported
• ✅ Retry Handlers supported
• ✅ Proxy support
• ✅ Pagination support
• ✅ All OAuth2 Authentications supported for use in ASP .NET and CLI apps
• ✅ Modular structure, for easy unit testing

Migration Guide

There is a migration guide from 5.x to 6.x here

If there are open questions regarding migration path, feel free to open an issue!

License

New Code base - New License. The project is now licensed under the MIT instead of the GPL V2. More freedom for your projects!

Documentation

The documentation site has been built from the ground up. While there is no online method documentation like before (refer to inline XML docs), there are now extensive guides and example infos available.

https://johnnycrazy.github.io/SpotifyAPI-NET/

Examples

Examples were a problem in the past. From now, v6 offers examples for every major .NET framework and application type (web, desktop, cli app) located in the SpotifyAPI.Web.Examples directory. There is still some documentation and linking (between documentation and github) to be done. Also, it's on the roadmap to create more advanced examples.

Feedback

Please provide any feedback, problems and ideas in #451 - Thank you!

Additional Changelog since beta.12

• Bumped dependencies
• Added more showcases to the docs
• UWP Example fixed
• Update to .NET 5

🏗 Fixes:

• Fixed SaveTracks/SaveShows/SaveAlbums endpoint always returning false ( part of #496 )

➕ Additions

• Playlists.RemoveItems now also accepts a list of positions. This allows to delete local files in playlists. A snapshotID MUST be provided.

var playlist = await spotify.Playlists.Get("YourPlaylistID");
var test = await spotify.Playlists.RemoveItems("YourPlaylistID", new PlaylistRemoveItemsRequest
{
  Positions = new List<int> { 0 },
  SnapshotId = playlist.SnapshotId
});