Merge pull request #169 from notion-dotnet/feature/168-add-support-to-retrieve-bot-user-assigned-to-a-token

Add support to retrieve bot user assigned to a token ✨

Author: KoditkarVedant

README.md

@@ -117,6 +117,7 @@ var complexFiler = new CompoundFilter(
 - [x] Users
   - [x] Retrieve a User
   - [x] List all users
+  - [x] Retrieve your token's bot user
 - [x] Search
 
 ## Contribution Guideline

Src/Notion.Client/Api/ApiEndpoints.cs

@@ -1,4 +1,6 @@
-namespace Notion.Client
+using System;
+
+namespace Notion.Client
 {
     public static class ApiEndpoints
     {
@@ -15,6 +17,12 @@ public static class UsersApiUrls
         {
             public static string Retrieve(string userId) => $"/v1/users/{userId}";
             public static string List() => "/v1/users";
+
+            /// <summary>
+            /// Get the <see cref="uri string"/> for retrieve your token's bot user.
+            /// </summary>
+            /// <returns>Returns a <see cref="uri string"/> retrieve your token's bot user.</returns>
+            public static string Me() => "/v1/users/me";
         }
 
         public static class BlocksApiUrls

Src/Notion.Client/Api/Users/IUsersClient.cs

@@ -6,5 +6,11 @@ public interface IUsersClient
     {
         Task<User> RetrieveAsync(string userId);
         Task<PaginatedList<User>> ListAsync();
+
+        /// <summary>
+        /// Retrieves the bot User associated with the API token provided in the authorization header.
+        /// </summary>
+        /// <returns>User object of type bot having an owner field with information about the person who authorized the integration.</returns>
+        Task<User> MeAsync();
     }
 }

Src/Notion.Client/Api/Users/UsersClient.cs

@@ -21,5 +21,14 @@ public async Task<PaginatedList<User>> ListAsync()
         {
             return await _client.GetAsync<PaginatedList<User>>(UsersApiUrls.List());
         }
+
+        /// <summary>
+        /// Retrieves the bot User associated with the API token provided in the authorization header.
+        /// </summary>
+        /// <returns>User object of type bot having an owner field with information about the person who authorized the integration.</returns>
+        public async Task<User> MeAsync()
+        {
+            return await _client.GetAsync<User>(UsersApiUrls.Me());
+        }
     }
 }

Src/Notion.Client/Models/User/Bot.cs

@@ -0,0 +1,10 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class Bot
+    {
+        [JsonProperty("owner")]
+        public IBotOwner Owner { get; set; }
+    }
+}

Src/Notion.Client/Models/User/BotOwner/IBotOwner.cs

@@ -0,0 +1,14 @@
+using JsonSubTypes;
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    [JsonConverter(typeof(JsonSubtypes), "type")]
+    [JsonSubtypes.KnownSubType(typeof(UserOwner), "user")]
+    [JsonSubtypes.KnownSubType(typeof(WorkspaceIntegrationOwner), "workspace")]
+    public interface IBotOwner
+    {
+        [JsonProperty("type")]
+        string Type { get; set; }
+    }
+}

Src/Notion.Client/Models/User/BotOwner/UserOwner.cs

@@ -0,0 +1,12 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class UserOwner : IBotOwner
+    {
+        public string Type { get; set; }
+
+        [JsonProperty("user")]
+        public User User { get; set; }
+    }
+}

Src/Notion.Client/Models/User/BotOwner/WorkspaceIntegrationOwner.cs

@@ -0,0 +1,12 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class WorkspaceIntegrationOwner : IBotOwner
+    {
+        public string Type { get; set; }
+
+        [JsonProperty("workspace")]
+        public bool Workspace { get; set; }
+    }
+}

Src/Notion.Client/Models/User/Person.cs

@@ -0,0 +1,10 @@
+using Newtonsoft.Json;
+
+namespace Notion.Client
+{
+    public class Person
+    {
+        [JsonProperty("email")]
+        public string Email { get; set; }
+    }
+}

Src/Notion.Client/Models/User.cs renamed to Src/Notion.Client/Models/User/User.cs

@@ -22,15 +22,4 @@ public class User : IObject
         [JsonProperty("bot")]
         public Bot Bot { get; set; }
     }
-
-    public class Person
-    {
-        [JsonProperty("email")]
-        public string Email { get; set; }
-    }
-
-    public class Bot
-    {
-
-    }
 }