Add contact details

Author: Suiram1701

API.Test/ProfileTests.cs

@@ -68,4 +68,18 @@ public void GetGenerallyInformation()
         else
             Assert.Fail();
     }
+
+    [Test]
+    public void GetContactDetails()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<(ContactDetails? contact, bool read, bool write)> contact = Client.GetContactDetailsAsync();
+        contact.Wait();
+
+        if (contact.Result.read)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
 }

WebUntisAPI.Client/Models/ContactDetails.cs

@@ -0,0 +1,99 @@
+using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace WebUntisAPI.Client.Models
+{
+    /// <summary>
+    /// Contact information about a user
+    /// </summary>
+    public class ContactDetails
+    {
+        /// <summary>
+        /// The person id
+        /// </summary>
+        [JsonProperty("personId")]
+        public int PersonId { get; set; }
+
+        /// <summary>
+        /// The person type id
+        /// </summary>
+        [JsonProperty("personType")]
+        public int PersonType { get; set; }
+
+        /// <summary>
+        /// The user id
+        /// </summary>
+        [JsonProperty("id")]
+        public int Id { get; set; }
+
+        /// <summary>
+        /// The user name
+        /// </summary>
+        [JsonProperty("name")]
+        public string Name { get; set; }
+
+        /// <summary>
+        /// For which person are this information
+        /// </summary>
+        [JsonProperty("addressType")]
+        public string AddressType { get; set; }
+
+        /// <summary>
+        /// The id for <see cref="AddressType"/>
+        /// </summary>
+        [JsonProperty("addressTypeValue")]
+        public int AddressTypeValue { get; set; }
+
+        /// <summary>
+        /// The street
+        /// </summary>
+        [JsonProperty("street")]
+        public string Street { get; set; }
+
+        /// <summary>
+        /// The city
+        /// </summary>
+        [JsonProperty("city")]
+        public string City { get; set; }
+
+        /// <summary>
+        /// The post code
+        /// </summary>
+        [JsonProperty("postCode")]
+        public string PostCode { get; set; }
+
+        /// <summary>
+        /// The country
+        /// </summary>
+        [JsonProperty("country")]
+        public string Country { get; set; }
+
+        /// <summary>
+        /// The email
+        /// </summary>
+        [JsonProperty("email")]
+        public string Email { get; set; }
+
+        /// <summary>
+        /// The phone number
+        /// </summary>
+        [JsonProperty("phone")]
+        public string PhoneNumber { get; set; }
+
+        /// <summary>
+        /// The mobile number
+        /// </summary>
+        [JsonProperty("mobile")]
+        public string MobileNumber { get; set; }
+
+        /// <summary>
+        /// The fax number
+        /// </summary>
+        [JsonProperty("fax")]
+        public string FaxNumber { get; set; }
+    }
+}

WebUntisAPI.Client/WebUntisclient.Profile.cs

@@ -215,10 +215,35 @@ public async Task<AccountConfig> GetAccountConfigAsync(CancellationToken ct = de
         /// </summary>
         /// <param name="ct">Cancellation token</param>
         /// <returns>The information</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<GeneralAccount> GetGenerallyAccountInformationAsync(CancellationToken ct = default)
         {
             string responseString = await MakeAPIGetRequestAsync("/WebUntis/api/profile/general", ct);
             return GeneralAccount.ReadFromJson(JObject.Parse(responseString)["data"].CreateReader());
         }
+
+        /// <summary>
+        /// Get the contact details for this account
+        /// </summary>
+        /// <param name="ct">Cancellation token</param>
+        /// <returns>When read is false the contact <see langword="null"/></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<(ContactDetails contact, bool read, bool write)> GetContactDetailsAsync(CancellationToken ct = default)
+        {
+            string responseString = await MakeAPIGetRequestAsync("/WebUntis/api/profile/contactdetails?personId=3299&isRequestForStudent=false", ct);
+            JObject data = JObject.Parse(responseString)["data"].Value<JObject>();
+
+            if (data["read"].Value<bool>())
+            {
+                ContactDetails contact = data["address"].ToObject<ContactDetails>();
+                return (contact, true, data["write"].Value<bool>());
+            }
+
+            return (null, false, data["write"].Value<bool>());
+        }
     }
 }