Add classreg events

Author: Suiram1701

WebUntisAPI.Client/Exceptions/WebUntisException.cs

@@ -7,7 +7,7 @@ namespace WebUntisAPI.Client.Exceptions
     /// <summary>
     /// An error that the WebUntis server returned
     /// </summary>
-    [DebuggerDisplay("Message = {Message}, Code = {Code}")]
+    [DebuggerDisplay("Message = {Message, nq}, Code = {Code, nq}")]
     public class WebUntisException : Exception
     {
         /// <summary>
@@ -41,9 +41,9 @@ public enum Codes
             NoSuchElementFound = -7002,
 
             /// <summary>
-            /// Access dinied for substitutions
+            /// Access dinied for the method
             /// </summary>
-            NoRightForGetSubstitutions = -8509
+            NoRightForMethod = -8509
         }
 
         /// <summary>

WebUntisAPI.Client/Models/ClassregEvent.cs

@@ -0,0 +1,67 @@
+using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using WebUntisAPI.Client.Converter;
+
+namespace WebUntisAPI.Client.Models
+{
+    /// <summary>
+    /// A classreg event
+    /// </summary>
+    [DebuggerDisplay("On: {Date, nq}, Student: {Forename, nq} {Surname, nq}")]
+    public class ClassregEvent
+    {
+        /// <summary>
+        /// The id of the involved student
+        /// </summary>
+        [JsonProperty("studentId")]
+        public int StudentId { get; set; }
+
+        /// <summary>
+        /// The forename of the involved student
+        /// </summary>
+        [JsonProperty("forename")]
+        public string Forename { get; set; }
+
+        /// <summary>
+        /// The surname of the involved student
+        /// </summary>
+        [JsonProperty("surname")]
+        public string Surname { get; set; }
+
+        /// <summary>
+        /// The date where the event happens
+        /// </summary>
+        [JsonProperty("date")]
+        [JsonConverter(typeof(DateJsonConverter))]
+        public DateTime Date { get; set; }
+
+        /// <summary>
+        /// The subject what is involved
+        /// </summary>
+        [JsonProperty("subject")]
+        public string Subject { get; set; }
+
+        /// <summary>
+        /// The reason why this happend
+        /// </summary>
+        [JsonProperty("reason")]
+        public string Reason { get; set; }
+
+        /// <summary>
+        /// Additional text to the event
+        /// </summary>
+        [JsonProperty("text")]
+        public string Text { get; set; }
+
+        /// <summary>
+        /// Id of the category
+        /// </summary>
+        [JsonProperty("categoryId")]
+        public int CategoryId { get; set; }
+    }
+}

WebUntisAPI.Client/Models/GetClassregEventsRequestModel.cs

@@ -0,0 +1,21 @@
+using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using WebUntisAPI.Client.Converter;
+
+namespace WebUntisAPI.Client.Models
+{
+    internal struct GetClassregEventsRequestModel
+    {
+        [JsonProperty("startDate")]
+        [JsonConverter(typeof(DateJsonConverter))]
+        public DateTime StartDate { get; set; }
+
+        [JsonProperty("endDate")]
+        [JsonConverter(typeof(DateJsonConverter))]
+        public DateTime EndDate { get; set; }
+    }
+}

WebUntisAPI.Client/WebUntisClient.Teaching.cs

@@ -90,5 +90,28 @@ public async Task<Department[]> GetAllDepartmentsAsync(string id = "getDepartmen
             List<Department> departments = await MakeRequestAsync<object, List<Department>>(id, "getDepartments", new object(), ct);
             return departments.ToArray();
         }
+
+        /// <summary>
+        /// Get all classreg events
+        /// </summary>
+        /// <param name="startDate">Start date for the requested events</param>
+        /// <param name="endDate">End date for the requested events</param>
+        /// <param name="id">Identifier for the request</param>
+        /// <param name="ct">Cancellatio token</param>
+        /// <returns>All classreg events in the given date range</returns>
+        /// <exception cref="ObjectDisposedException">Thrown when the instance was disposed</exception>
+        /// <exception cref="UnauthorizedAccessException">Thrown when you're not logged in</exception>
+        /// <exception cref="HttpRequestException">Thrown when an error happend while the http request</exception>
+        /// <exception cref="WebUntisException">Thrown when the WebUntis API returned an error</exception>
+        public async Task<ClassregEvent[]> GetClassregEventsAsync(DateTime startDate, DateTime endDate, string id = "getCLassregEvents", CancellationToken ct = default)
+        {
+            GetClassregEventsRequestModel model = new GetClassregEventsRequestModel()
+            {
+                StartDate = startDate,
+                EndDate = endDate
+            };
+            List<ClassregEvent> classregEvents = await MakeRequestAsync<GetClassregEventsRequestModel, List<ClassregEvent>>(id, "getClassregEvents", model, ct);
+            return classregEvents.ToArray();
+        }
     }
 }