Skip to content

Commit 17b303c

Browse files
committed
Merge tag 'v0.1.0' into develop
v0.1.0 v0.1.0
2 parents ca72b22 + 268b88f commit 17b303c

42 files changed

Lines changed: 70 additions & 211 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

README.md

Lines changed: 42 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,43 @@
11
# WebUntisAPI.Client
2-
Documentation will follow after initial publication.
2+
3+
This .NET library allows you to connect you with a WebUntis account and load all of the data you need from there.<br>
4+
5+
## Download sources:
6+
- [![GitHub](https://img.shields.io/badge/GitHub-Releases-black)](https://github.com/Suiram1701/WebUntisAPI.Client/releases)<br>
7+
- [![NuGet](https://img.shields.io/badge/NuGet-Package-blue)](https://www.nuget.org/packages/WebUntisAPI.Client)
8+
9+
## Documentation:
10+
The documentation is integrated in the package so that all classes and methods explain what they do. Here're the basics to use the library:
11+
12+
### Add references to this library
13+
The simplest way is to add the [NuGet](https://www.nuget.org/packages/WebUntisAPI.Client) package to your project,
14+
but when you don't want to use NuGet you can also download the [binarys](https://github.com/Suiram1701/WebUntisAPI.Client/releases) of the package and add the reference the contained .dll
15+
16+
### 1. Creating a client and login:
17+
18+
```C#
19+
using (WebUntisClient client = new WebUntisClient("App name"))
20+
{
21+
await client.LoginAsync("example.webuntis.com", "exampleSchool", "username", "password")
22+
// Here can you send your requests
23+
}
24+
```
25+
Overloads:<br>
26+
The `LoginAsync()` method has an overload where you can use instead of the `serverName` and the `loginName` an instance of `School` that returned from the school search.
27+
28+
Remarks:<br>
29+
- When you use the client in a using statement you would automatically logged out when it disposed
30+
- Under no circumstances should 10 req. per sec., more than 1800req. per hr (but in no case more than 3600 req. per hr). If the specifications are exceeded, access to WebUntis could permanently blocked by the WebUntis API.
31+
32+
### 2. Send requests
33+
After your login you can send requests to get informations about your timetable and all about.<br>
34+
The methods an what they do shoud be self-explained.<br>
35+
36+
## Issues
37+
When you had an error that you don't understand or you don't understand how you can use the library you can create an issue so that I can help you by your problem.
38+
[![GitHub](https://img.shields.io/badge/GitHub-Issues-red)](https://github.com/Suiram1701/WebUntisAPI.Client/issues)
39+
40+
<hr>
41+
42+
This is an unofficial library that I created from the WebUntis API [documentation](https://untis-sr.ch/wp-content/uploads/2019/11/2018-09-20-WebUntis_JSON_RPC_API.pdf).
43+

WebUntisAPI.Client/Converter/ClassJsonConverter.cs

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,6 @@
22
using Newtonsoft.Json.Linq;
33
using System;
44
using System.Collections.Generic;
5-
using System.IO;
6-
using System.Linq;
7-
using System.Runtime.Serialization.Formatters;
8-
using System.Text;
9-
using System.Threading.Tasks;
105
using WebUntisAPI.Client.Models;
116

127
namespace WebUntisAPI.Client.Converter

WebUntisAPI.Client/Converter/ColorJsonConverter.cs

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,7 @@
11
using Newtonsoft.Json;
22
using Newtonsoft.Json.Linq;
33
using System;
4-
using System.Collections.Generic;
54
using System.Drawing;
6-
using System.Linq;
7-
using System.Text;
8-
using System.Text.RegularExpressions;
9-
using System.Threading.Tasks;
105
using WebUntisAPI.Client.Extensions;
116

127
namespace WebUntisAPI.Client.Converter

WebUntisAPI.Client/Converter/DateJsonConverter.cs

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,6 @@
11
using Newtonsoft.Json;
22
using Newtonsoft.Json.Linq;
33
using System;
4-
using System.Collections.Generic;
5-
using System.Linq;
6-
using System.Text;
7-
using System.Threading.Tasks;
84
using WebUntisAPI.Client.Extensions;
95

106
namespace WebUntisAPI.Client.Converter

WebUntisAPI.Client/Converter/StatusDataJsonConverter.cs

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,7 @@
22
using Newtonsoft.Json.Linq;
33
using System;
44
using System.Collections.Generic;
5-
using System.Drawing;
65
using System.Linq;
7-
using System.Text;
8-
using System.Threading.Tasks;
96
using WebUntisAPI.Client.Models;
107

118
namespace WebUntisAPI.Client.Converter

WebUntisAPI.Client/Converter/TimeJsonConverter.cs

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,6 @@
11
using Newtonsoft.Json;
22
using Newtonsoft.Json.Linq;
33
using System;
4-
using System.Collections.Generic;
5-
using System.Linq;
6-
using System.Text;
7-
using System.Threading.Tasks;
84
using WebUntisAPI.Client.Extensions;
95

106
namespace WebUntisAPI.Client.Converter

WebUntisAPI.Client/Converter/TimegridJsonConverter.cs

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,6 @@
33
using System;
44
using System.Collections.Generic;
55
using System.Linq;
6-
using System.Text;
7-
using System.Threading.Tasks;
8-
using WebUntisAPI.Client.Extensions;
96
using WebUntisAPI.Client.Models;
107

118
namespace WebUntisAPI.Client.Converter

WebUntisAPI.Client/Converter/TimetableRequestModelJsonConverter.cs

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,6 @@
11
using Newtonsoft.Json;
22
using Newtonsoft.Json.Linq;
33
using System;
4-
using System.Collections.Generic;
5-
using System.Linq;
6-
using System.Text;
7-
using System.Threading.Tasks;
84
using WebUntisAPI.Client.Extensions;
95
using WebUntisAPI.Client.Models;
106

WebUntisAPI.Client/Enums.cs

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,4 @@
11
using Newtonsoft.Json;
2-
using System;
3-
using System.Collections.Generic;
4-
using System.Linq;
5-
using System.Text;
6-
using System.Threading.Tasks;
72

83
namespace WebUntisAPI.Client
94
{

WebUntisAPI.Client/Exceptions/WebUntisException.cs

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,6 @@
11
using Newtonsoft.Json;
22
using System;
3-
using System.Collections.Generic;
43
using System.Diagnostics;
5-
using System.Linq;
6-
using System.Runtime.Serialization;
7-
using System.Text;
8-
using System.Threading.Tasks;
94

105
namespace WebUntisAPI.Client.Exceptions
116
{

0 commit comments

Comments
 (0)