168 lines
7.1 KiB
Markdown
168 lines
7.1 KiB
Markdown
## API
|
|
|
|
> Wenn die env variable `API_SECRET` gesetzt ist, muss jede API Request den HTTP Header `Authorization: Basic <API_SECRET>` haben.
|
|
|
|
<details>
|
|
<summary><code>POST</code> <code>/api/feedback</code> (Erstellt Feedbackformulare)</summary>
|
|
|
|
##### Request Body
|
|
|
|
```
|
|
{
|
|
// Interner Event Name (oder ID)
|
|
"event": string,
|
|
// Event Titel, wird über dem Feedbackformular angezeigt
|
|
"title": string,
|
|
// UUIDs aller Spieler, die das Feedback ausfüllen sollen
|
|
"users": string[]
|
|
}
|
|
```
|
|
|
|
##### Response Codes
|
|
|
|
| http code | beschreibung |
|
|
| --------- | ------------------------------------------ |
|
|
| 200 | / |
|
|
| 400 | Der Request Body ist falsch |
|
|
| 401 | Es wurde ein falsches API Secret angegeben |
|
|
|
|
##### Response Body
|
|
|
|
```
|
|
{
|
|
"feedback": {
|
|
// UUID eines Spieler
|
|
"uuid": string
|
|
// URL zum Feedbackformular
|
|
"url": string
|
|
}[]
|
|
}
|
|
```
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary><code>POST</code> <code>/api/report</code> (Erstellt einen Report)</summary>
|
|
|
|
##### Request Body
|
|
|
|
```
|
|
{
|
|
// UUID des Report Erstellers
|
|
"reporter": string,
|
|
// UUID des Reporteten Spielers
|
|
"reported": string | null,
|
|
// Report Grund
|
|
"reason": string
|
|
}
|
|
```
|
|
|
|
##### Response Codes
|
|
|
|
| http code | beschreibung |
|
|
| --------- | ----------------------------------------------------------------- |
|
|
| 200 | / |
|
|
| 400 | Der Request Body ist falsch |
|
|
| 401 | Es wurde ein falsches API Secret angegeben |
|
|
| 404 | Der Report Ersteller, oder der reportete Spieler, existiert nicht |
|
|
|
|
##### Response Body
|
|
|
|
```
|
|
{
|
|
// URL, wo der Ersteller den Report abschicken kann
|
|
"url": string
|
|
}
|
|
```
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary><code>PUT</code> <code>/api/report</code> (Erstellt einen Abgeschlossenen Report)</summary>
|
|
|
|
##### Request Body
|
|
|
|
```
|
|
{
|
|
// UUID des Reporters. Wenn `null`, wird der Reporter als System interpretiert
|
|
"reporter": string | null,
|
|
// UUID des Reporteten Spielers
|
|
"reported": string,
|
|
// Report Grund
|
|
"reason": string,
|
|
// Inhalt des Reports
|
|
"body": string | null,
|
|
// Interne Notiz
|
|
"notice": string | null,
|
|
// Öffentliches Statement
|
|
"statement": string | null,
|
|
// ID des Strikegrundes
|
|
"strike_reason_id": number
|
|
}
|
|
```
|
|
|
|
| http code | beschreibung |
|
|
| --------- | ----------------------------------------------------------------- |
|
|
| 200 | / |
|
|
| 400 | Der Request Body ist falsch |
|
|
| 401 | Es wurde ein falsches API Secret angegeben |
|
|
| 404 | Der Report Ersteller, oder der reportete Spieler, existiert nicht |
|
|
|
|
##### Response Body
|
|
|
|
`/`
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary><code>GET</code> <code>/api/player</code> (Status eines Spielers)</summary>
|
|
|
|
##### Request Body
|
|
|
|
```
|
|
{
|
|
// UUID eines Spielers
|
|
"user": string
|
|
}
|
|
```
|
|
|
|
| http code | beschreibung |
|
|
| --------- | ------------------------------------------ |
|
|
| 200 | / |
|
|
| 400 | Der Request Body ist falsch |
|
|
| 401 | Es wurde ein falsches API Secret angegeben |
|
|
| 404 | Der Spieler existiert nicht |
|
|
|
|
##### Response Body
|
|
|
|
```
|
|
{
|
|
// Liste aller Strikes, die der Spieler hat
|
|
strikes: {
|
|
// UTC Timestamp wann der Strike erstellt wurde
|
|
"at": number,
|
|
// Strike Gewichtung
|
|
"weight": number,
|
|
}[]
|
|
}
|
|
```
|
|
|
|
</details>
|
|
|
|
## Webhook
|
|
|
|
> Die env variable `WEBHOOK_ENDPOINT` muss gesetzt und eine valide HTTP URL sein.
|
|
|
|
Bei bestimmten Aktionen wird an den Webhook Endpoint ein Webhook gesendet.
|
|
Die Art des Webhooks wird dabei durch den `x-webhook-action` HTTP Header angegeben und hat einen festgelegten JSON Body.
|
|
|
|
Das Webhook wir so oft gesendet, bis der angegebene Webhook Endpoint eine Response mit Status `200` zurücksendet.
|
|
|
|
Alle Webhooks:
|
|
|
|
| Beschreibung | HTTP Header | Body |
|
|
| ------------------------------------- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- |
|
|
| Ein neuer Nutzer hat sich registriert | <pre>x-webhook-action: signup</pre> | <pre>{<br> // Vorname des Nutzers<br> firstname: string,<br> // Nachname des Nutzers<br> lastname: string,<br> //Geburtstag des Nutzers im YYYY-MM-DD format<br> birthday: string,<br> // Telefonnummer des Nutzers. `null` wenn keine angegeben wurde<br> telephone: string \| null,<br> // Spielername des Nutzers<br> username: string,<br> // Minecraft-Edition des Nutzers<br> edition: 'java' \| 'bedrock'</pre> |
|
|
| Ein neuer Report wurde erstellt | <pre>x-webhook-action: report</pre> | <pre>{<br> // Username des Reporters. `null` wenn der Report vom System gemacht wurde<br> reporter: string \| null,<br> // Username des reporteten Spielers. `null` wenn Spieler unbekannt ist<br> reported: string \| null,<br> // Grund des Reports<br> reason: string<br>}</pre> | |
|
|
| Ein Team hat ein Strike bekommen | <pre>x-webhook-action: strike</pre> | <pre>{<br> // UUIDs aller Nutzer des Teams, das einen Strike bekommen hat<br> "users": string[],<br> // Gewichtung aller Strikes, die das Team insgesamt bekommen hat<br> "totalWeight": number<br>}</pre> |
|