Added new endpoint "recently played"

Author: JohnnyCrazy

SpotifyAPI.Example/WebControl.cs

@@ -37,6 +37,8 @@ private async void InitialSetup()
                 return;
             }
 
+            var test = _spotify.GetUsersRecentlyPlayedTracks();
+
             authButton.Enabled = false;
             _profile = _spotify.GetPrivateProfile();
 
@@ -108,7 +110,8 @@ private async void RunAuthentication()
                 8000,
                 "26d287105e31491889f3cd293d85bfea",
                 Scope.UserReadPrivate | Scope.UserReadEmail | Scope.PlaylistReadPrivate | Scope.UserLibraryRead |
-                Scope.UserReadPrivate | Scope.UserFollowRead | Scope.UserReadBirthdate | Scope.UserTopRead | Scope.PlaylistReadCollaborative);
+                Scope.UserReadPrivate | Scope.UserFollowRead | Scope.UserReadBirthdate | Scope.UserTopRead | Scope.PlaylistReadCollaborative |
+                Scope.UserReadRecentlyPlayed);
 
             try
             {

SpotifyAPI/SpotifyAPI.csproj

@@ -90,6 +90,7 @@
     <Compile Include="Web\Models\FullArtist.cs" />
     <Compile Include="Web\Models\FullTrack.cs" />
     <Compile Include="Web\Models\NewAlbumReleases.cs" />
+    <Compile Include="Web\Models\PlayHistory.cs" />
     <Compile Include="Web\Models\Recommendations.cs" />
     <Compile Include="Web\Models\RecommendationSeed .cs" />
     <Compile Include="Web\Models\RecommendationSeedGenres.cs" />

SpotifyAPI/Web/Enums/Scope.cs

@@ -45,6 +45,9 @@ public enum Scope
         UserTopRead = 4096,
 
         [String("playlist-read-collaborative")]
-        PlaylistReadCollaborative = 8192
+        PlaylistReadCollaborative = 8192,
+
+        [String("user-read-recently-played")]
+        UserReadRecentlyPlayed = 16384
     }
 }

SpotifyAPI/Web/Models/CursorPaging.cs

@@ -4,7 +4,7 @@
 
 namespace SpotifyAPI.Web.Models
 {
-    public class CursorPaging<T>
+    public class CursorPaging<T> : BasicModel
     {
         [JsonProperty("href")]
         public string Href { get; set; }

SpotifyAPI/Web/Models/GeneralModels.cs

@@ -137,5 +137,23 @@ public class Cursor
     {
         [JsonProperty("after")]
         public string After { get; set; }
+
+        [JsonProperty("before")]
+        public string Before { get; set; }
+    }
+
+    public class Context
+    {
+        [JsonProperty("type")]
+        public string Type { get; set; }
+
+        [JsonProperty("href")]
+        public string Href { get; set; }
+
+        [JsonProperty("external_urls")]
+        public Dictionary<string, string> ExternalUrls { get; set; }
+
+        [JsonProperty("uri")]
+        public string Uri { get; set; }
     }
 }

SpotifyAPI/Web/Models/PlayHistory.cs

@@ -0,0 +1,17 @@
+using System;
+using Newtonsoft.Json;
+
+namespace SpotifyAPI.Web.Models
+{
+    public class PlayHistory : BasicModel
+    {
+        [JsonProperty("track")]
+        public SimpleTrack Track { get; set; }
+
+        [JsonProperty("played_at")]
+        public DateTime PlayedAt { get; set; }
+
+        [JsonProperty("context")]
+        public Context Context { get; set; }
+    }
+}

SpotifyAPI/Web/SpotifyWebAPI.cs

@@ -1240,6 +1240,34 @@ public Task<Paging<FullArtist>> GetUsersTopArtistsAsync(TimeRangeType timeRange
             return DownloadDataAsync<Paging<FullArtist>>(_builder.GetUsersTopArtists(timeRange, limit, offest));
         }
 
+        /// <summary>
+        ///     Get tracks from the current user’s recent play history.
+        /// </summary>
+        /// <param name="limit">The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. </param>
+        /// <param name="after">A Unix timestamp in milliseconds. Returns all items after (but not including) this cursor position. If after is specified, before must not be specified.</param>
+        /// <param name="before">A Unix timestamp in milliseconds. Returns all items before (but not including) this cursor position. If before is specified, after must not be specified.</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public CursorPaging<PlayHistory> GetUsersRecentlyPlayedTracks(int limit = 20, DateTime? after = null,
+            DateTime? before = null)
+        {
+            return DownloadData<CursorPaging<PlayHistory>>(_builder.GetUsersRecentlyPlayedTracks(limit, after, before));
+        }
+
+        /// <summary>
+        ///     Get tracks from the current user’s recent play history asynchronously
+        /// </summary>
+        /// <param name="limit">The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. </param>
+        /// <param name="after">A Unix timestamp in milliseconds. Returns all items after (but not including) this cursor position. If after is specified, before must not be specified.</param>
+        /// <param name="before">A Unix timestamp in milliseconds. Returns all items before (but not including) this cursor position. If before is specified, after must not be specified.</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public Task<CursorPaging<PlayHistory>> GetUsersRecentlyPlayedTracksAsync(int limit = 20, DateTime? after = null,
+            DateTime? before = null)
+        {
+            return DownloadDataAsync<CursorPaging<PlayHistory>>(_builder.GetUsersRecentlyPlayedTracks(limit, after, before));
+        }
+
         #endregion
 
         #region Playlists

SpotifyAPI/Web/SpotifyWebBuilder.cs

@@ -587,6 +587,26 @@ public string GetUsersTopArtists(TimeRangeType timeRange = TimeRangeType.MediumT
             return builder.ToString();
         }
 
+        /// <summary>
+        ///     Get tracks from the current user’s recent play history.
+        /// </summary>
+        /// <param name="limit">The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. </param>
+        /// <param name="after">A Unix timestamp in milliseconds. Returns all items after (but not including) this cursor position. If after is specified, before must not be specified.</param>
+        /// <param name="before">A Unix timestamp in milliseconds. Returns all items before (but not including) this cursor position. If before is specified, after must not be specified.</param>
+        /// <returns></returns>
+        /// <remarks>AUTH NEEDED</remarks>
+        public string GetUsersRecentlyPlayedTracks(int limit = 20, DateTime? after = null, DateTime? before = null)
+        {
+            limit = Math.Min(50, limit);
+            StringBuilder builder = new StringBuilder($"{APIBase}/me/player/recently-played");
+            builder.Append("?limit=" + limit);
+            if (after.HasValue)
+                builder.Append("&after=" + after.Value.ToUnixTimeMillisecondsPoly());
+            if (before.HasValue)
+                builder.Append("&before=" + before.Value.ToUnixTimeMillisecondsPoly());
+            return builder.ToString();
+        }
+
         #endregion
 
         #region Playlists

SpotifyAPI/Web/Util.cs

@@ -22,6 +22,11 @@ public static string GetStringAttribute<T>(this T en, string separator) where T
             attributes.ToList().ForEach(element => list.Add(element.Text));
             return string.Join(separator, list);
         }
+
+        public static int ToUnixTimeMillisecondsPoly(this DateTime time)
+        {
+            return (int)time.Subtract(new DateTime(1970, 1, 1)).TotalMilliseconds;
+        }
     }
 
     public sealed class StringAttribute : Attribute