Add method to get message permissions

Author: Suiram1701

API.Test/MessagesTests.cs

@@ -3,6 +3,7 @@
 using System.Linq;
 using System.Text;
 using System.Threading.Tasks;
+using WebUntisAPI.Client.Models;
 using static API.Test.AuthentificationTests;
 
 namespace API.Test;
@@ -21,4 +22,17 @@ public void GetUnreadMessages()
         else
             Assert.Fail();
     }
+
+    [Test]
+    public void GetMessagePermissions()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<MessagePermissions> permissions = Client.GetMessagePermissionsAsync();
+        permissions.Wait();
+        if (permissions.Result != null)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
 }

WebUntisAPI.Client/Models/MessagePermissions.cs

@@ -0,0 +1,72 @@
+using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace WebUntisAPI.Client.Models
+{
+    /// <summary>
+    /// Information about the permissions you have for messages
+    /// </summary>
+    public class MessagePermissions
+    {
+        /// <summary>
+        /// To wich persons you could send the message
+        /// </summary>
+        /// <remarks>
+        /// Possible values are:
+        ///     <list type="bullet">
+        ///         <item>TEACHER</item>
+        ///         <item>STUDENT</item>
+        ///         <item>CLASS</item>
+        ///     </list>
+        /// </remarks>
+        [JsonProperty("recipientOptions")]
+        public string[] RecipientOptions { get; set; }
+
+        /// <summary>
+        /// allow request read confirmation
+        /// </summary>
+        [JsonProperty("allowRequestReadConfirmation")]
+        public bool AllowRequestReadConfirmation { get; set; }
+
+        /// <summary>
+        /// How much recipient are listed in the search result
+        /// </summary>
+        [JsonProperty("recipientSearchMaxResult")]
+        public int RecipientSearchMaxResult { get; set; }
+
+        /// <summary>
+        /// Can you save drafts
+        /// </summary>
+        [JsonProperty("showDraftsTab")]
+        public bool ShowDraftsTab { get; set; }
+
+        /// <summary>
+        /// Can you send messages
+        /// </summary>
+        [JsonProperty("showSentTab")]
+        public bool ShowSentTab { get; set; }
+
+        /// <summary>
+        /// Can you forbid replies
+        /// </summary>
+        [JsonProperty("canForbidReplies")]
+        public bool CanForbidReplies { get; set; }
+
+        /// <summary>
+        /// The maximum size of a file you could attach in bytes
+        /// </summary>
+        [JsonProperty("maxFileSize")]
+        public long MaxFileSize { get; set; }
+
+        /// <summary>
+        /// The maximum count of files you could attach
+        /// </summary>
+        [JsonProperty("maxFileCount")]
+        public int MaxFileCount { get; set; }
+    }
+}
+

WebUntisAPI.Client/WebUntisClient.Messages.cs

@@ -1,4 +1,5 @@
-using Newtonsoft.Json.Linq;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Linq;
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -7,6 +8,7 @@
 using System.Text;
 using System.Threading;
 using System.Threading.Tasks;
+using WebUntisAPI.Client.Models;
 
 namespace WebUntisAPI.Client
 {
@@ -49,5 +51,43 @@ public async Task<int> GetUnreadMessagesCountAsync(CancellationToken ct = defaul
 
             return JObject.Parse(await response.Content.ReadAsStringAsync()).Value<int>("unreadMessagesCount");
         }
+
+        /// <summary>
+        /// Get the permissions you have to send messages
+        /// </summary>
+        /// <param name="ct">Cancllation token</param>
+        /// <returns></returns>
+        /// <exception cref="ObjectDisposedException">Thrown when the instance was disposed</exception>
+        /// <exception cref="UnauthorizedAccessException">Thrown when you're logged in</exception>
+        /// <exception cref="HttpRequestException">Thrown when an error happened while the http request</exception>
+        public async Task<MessagePermissions> GetMessagePermissionsAsync(CancellationToken ct = default)
+        {
+            // Check for disposing
+            if (_disposedValue)
+                throw new ObjectDisposedException(GetType().FullName);
+
+            // Check if you logged in
+            if (!LoggedIn)
+                throw new UnauthorizedAccessException("You're not logged in");
+
+            HttpRequestMessage request = new HttpRequestMessage()
+            {
+                Method = HttpMethod.Get,
+                RequestUri = new Uri(ServerUrl + "/WebUntis/api/rest/view/v1/messages/permissions")
+            };
+            SetRequestHeader(request.Headers, true);
+
+            HttpResponseMessage response = await _client.SendAsync(request, ct);
+
+            // Check cancellation token
+            if (ct.IsCancellationRequested)
+                return default;
+
+            // Verify response
+            if (response.StatusCode != HttpStatusCode.OK)
+                throw new HttpRequestException($"There was an error while the http request (Code: {response.StatusCode}).");
+
+            return JsonConvert.DeserializeObject<MessagePermissions>(await response.Content.ReadAsStringAsync());
+        }
     }
 }