Add holidays

Author: Suiram1701

API.Test/TimeTableTests.cs

@@ -63,4 +63,17 @@ public void GetCurrentSchoolYear()
         else
             Assert.Fail();
     }
+
+    [Test]
+    public void GetHolidays()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<Holidays[]> holidays = Client.GetAllHolidaysAsync();
+        holidays.Wait();
+        if (holidays.Result.Length > 0)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
 }

WebUntisAPI.Client/Models/Holidays.cs

@@ -0,0 +1,50 @@
+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 holiday
+    /// </summary>
+    [DebuggerDisplay("Name = {LongName}")]
+    public struct Holidays
+    {
+        /// <summary>
+        /// The id of the holiday
+        /// </summary>
+        [JsonProperty("id")]
+        public int Id { get; set; }
+
+        /// <summary>
+        /// Short name of the holiday
+        /// </summary>
+        [JsonProperty("name")]
+        public string Name { get; set; }
+
+        /// <summary>
+        /// The normal name of the holiday
+        /// </summary>
+        [JsonProperty("longName")]
+        public string LongName { get; set; }
+
+        /// <summary>
+        /// The start date of the holiday
+        /// </summary>
+        [JsonProperty("startDate")]
+        [JsonConverter(typeof(DateJsonConverter))]
+        public DateTime StartDate { get; set; }
+
+        /// <summary>
+        /// The end date of the holiday
+        /// </summary>
+        [JsonProperty("endDate")]
+        [JsonConverter(typeof(DateJsonConverter))]
+        public DateTime EndDate { get; set; }
+    }
+}

WebUntisAPI.Client/Models/SchoolYearModel.cs

@@ -9,7 +9,7 @@ namespace WebUntisAPI.Client.Models
 {
     internal struct SchoolYearModel
     {
-        [JsonProperty("id")]
+        [JsonProperty("schoolyearId")]
         public int Id { get; set; }
     }
 }

WebUntisAPI.Client/Models/StatusData.cs

@@ -21,20 +21,25 @@ public class StatusData
         public ForeBackColors LessonColors { get; set; }
 
         /// <summary>
-        /// idk
+        /// Colors for a office hour
         /// </summary>
         public ForeBackColors OhColors { get; set; }
 
         /// <summary>
-        /// idk
+        /// Colors for a standby
         /// </summary>
         public ForeBackColors SbColors { get; set; }
 
         /// <summary>
-        /// idk
+        /// Colors for a break supervision
         /// </summary>
         public ForeBackColors BsColors { get; set; }
 
+        /// <summary>
+        /// Colors for a examination
+        /// </summary>
+        public ForeBackColors ExColors { get; set; }
+
         /// <summary>
         /// Colors for cancelled lessons
         /// </summary>

WebUntisAPI.Client/WebUntisClient.TimeTable.cs

@@ -65,11 +65,31 @@ public async Task<SchoolYear[]> GetAllSchoolYearsAsync(string id = "getSchoolyea
         /// </summary>
         /// <param name="id">Identifier for the request</param>
         /// <param name="ct">Cancellation token</param>
-        /// <returns></returns>
+        /// <returns>The current school year</returns>
+        /// <exception cref="ObjectDisposedException">Thrown when thew 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<SchoolYear> GetCurrentSchoolYearAsync(string id = "getCurrentSchoolyear", CancellationToken ct = default)
         {
             SchoolYear schoolYear = await MakeRequestAsync<object, SchoolYear>(id, "getCurrentSchoolyear", new object(), ct);
             return schoolYear;
         }
+
+        /// <summary>
+        /// Get all holidays async
+        /// </summary>
+        /// <param name="id">Identifier for the request</param>
+        /// <param name="ct">Cancellation token</param>
+        /// <returns>All holidays</returns>
+        /// <exception cref="ObjectDisposedException">Thrown when thew 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<Holidays[]> GetAllHolidaysAsync(string id = "getHolidays", CancellationToken ct = default)
+        {
+            List<Holidays> holidays = await MakeRequestAsync<object, List<Holidays>>(id, "getHolidays", new object(), ct);
+            return holidays.ToArray();
+        }
     }
 }