Add get Person id method, rename LoginModel to LoginRequestModel

Author: Suiram1701

API.Test/UserTest.cs

@@ -42,10 +42,17 @@ public void GetTeachers()
             Assert.Fail();
     }
 
-    [Order(3)]
     [Test]
-    public void TearUp()
+    [Order(3)]
+    public void GetPersonId()
     {
-        Client.LogoutAsync().Wait();
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<int> personId = Client.GetPersonIdAsync(Client.User.ForeName, Client.User.LongName, Client.UserType ?? UserType.Student);
+        personId.Wait();
+        if (personId.Result == Client.User.Id)
+            Assert.Pass();
+        else
+            Assert.Fail();
     }
 }

WebUntisAPI.Client/Models/GetPersonIdRequestModel.cs

@@ -0,0 +1,24 @@
+using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace WebUntisAPI.Client.Models
+{
+    internal struct GetPersonIdRequestModel
+    {
+        [JsonProperty("fn")]
+        public string Forename { get; set; }
+
+        [JsonProperty("sn")]
+        public string Surname { get; set; }
+
+        [JsonProperty("type")]
+        public int UserType { get; set; }
+
+        [JsonProperty("dob")]
+        public const int s_Bithdate = 0;
+    }
+}

WebUntisAPI.Client/Models/LoginModel.cs …isAPI.Client/Models/LoginRequestModel.csWebUntisAPI.Client/Models/LoginModel.cs renamed to WebUntisAPI.Client/Models/LoginRequestModel.cs WebUntisAPI.Client/Models/LoginModel.cs renamed to WebUntisAPI.Client/Models/LoginRequestModel.cs

@@ -5,7 +5,8 @@ namespace WebUntisAPI.Client.Models
     /// <summary>
     /// Model for the param of the login
     /// </summary>
-    internal struct LoginModel
+    internal struct LoginRequestModel
+
     {
         /// <summary>
         /// Username to login

WebUntisAPI.Client/WebUntisClient.TimeTable.cs

@@ -103,7 +103,7 @@ public async Task<Holidays[]> GetAllHolidaysAsync(string id = "getHolidays", Can
         /// <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<Period[]> GetOwnTimetableAsync(DateTime startDate = default, DateTime endDate = default, string id = "GetTimtableForClass", CancellationToken ct = default)
+        public async Task<Period[]> GetOwnTimetableAsync(DateTime startDate = default, DateTime endDate = default, string id = "GetOwnTimtable", CancellationToken ct = default)
         {
             if (UserType == Client.UserType.Student)
                 return await GetTimetableForStudentAsync((Student)User, startDate, endDate, id, ct);

WebUntisAPI.Client/WebUntisClient.User.cs

@@ -59,5 +59,29 @@ public async Task<Teacher[]> GetAllTeachersAsync(string id = "getTeachers", Canc
             List<Teacher> teachers = await MakeRequestAsync<object, List<Teacher>>(id, "getTeachers", new object(), ct);
             return teachers.ToArray();
         }
+
+        /// <summary>
+        /// Search for the id of a user where you know fore- and surname
+        /// </summary>
+        /// <param name="forename">Forename of the user (It doesn't matter if it is upper or lower case)</param>
+        /// <param name="surname">Surname of the user (It doesn't matter if it is upper or lower case)</param>
+        /// <param name="type">Type of the user</param>
+        /// <param name="id">Identifier for the request</param>
+        /// <param name="ct">Cancellation token</param>
+        /// <returns>The <see cref="IUser.Id"/> of the requested user. 0 if the user isn't found</returns>
+        /// <exception cref="UnauthorizedAccessException">Thrown when you're not logged in</exception>
+        /// <exception cref="HttpRequestException">Thrown when there was an error while the http request</exception>
+        /// <exception cref="WebUntisException">Thrown when the WebUntis API returned an error</exception>
+        /// <exception cref="ObjectDisposedException">Thrown when the object is disposed</exception>
+        public async Task<int> GetPersonIdAsync(string forename, string surname, UserType type, string id = "getPersonId", CancellationToken ct = default)
+        {
+            GetPersonIdRequestModel model = new GetPersonIdRequestModel()
+            {
+                Forename = forename,
+                Surname = surname,
+                UserType = (int)type
+            };
+            return await MakeRequestAsync<GetPersonIdRequestModel, int>(id, "getPersonId", model, ct);
+        }
     }
 }

WebUntisAPI.Client/WebUntisClient.cs

@@ -126,11 +126,11 @@ public async Task<bool> LoginAsync(string server, string loginName, string usern
             string serverUrl = "https://" + serverName.Value;
 
             // Make request for login
-            JSONRPCRequestModel<LoginModel> requestModel = new JSONRPCRequestModel<LoginModel>()
+            JSONRPCRequestModel<LoginRequestModel> requestModel = new JSONRPCRequestModel<LoginRequestModel>()
             {
                 Id = id,
                 Method = "authenticate",
-                Params = new LoginModel()
+                Params = new LoginRequestModel()
                 {
                     User = username,
                     Password = password,