CHANGE: docs
This commit is contained in:
80
Readme.md
80
Readme.md
@@ -5,9 +5,81 @@ bis jetzt ein einfaches Backend mit PostgreSQL Datenbank und GO Webserver um Arb
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
git clone https://git.letsstein.de/tom/arbeitszeitmessung
|
||||
git clone https://git.letsstein.de/tom/arbeitszeitmessung arbeitszeitmessung
|
||||
|
||||
# cd in das Verzeichnis
|
||||
|
||||
cd Docker
|
||||
cd arbeitszeitmessung/Docker
|
||||
# .env Datei anpassen
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
## API
|
||||
Nutzung der API
|
||||
|
||||
### Buchungen [/time]
|
||||
|
||||
#### [GET] Anfrage
|
||||
Parameter: cardID (string)
|
||||
Antwort: `200`
|
||||
```json
|
||||
[
|
||||
{
|
||||
"cradID": "test_card",
|
||||
"readerID": "test_reader",
|
||||
"bookingTyp": 2,
|
||||
"loggedTime": "2024-09-05T08:37:53.117641Z",
|
||||
"id": 5
|
||||
},
|
||||
{
|
||||
"cradID": "test_card",
|
||||
"readerID": "mytest",
|
||||
"bookingTyp": 1,
|
||||
"loggedTime": "2024-09-05T08:51:12.670827Z",
|
||||
"id": 6
|
||||
},
|
||||
]
|
||||
```
|
||||
Antwort `500`
|
||||
Serverfehler
|
||||
|
||||
#### [PUT] Anfrage
|
||||
Parameter: id (int)
|
||||
Body: (veränderte Parameter)
|
||||
```json
|
||||
{
|
||||
"cradID": "test_card",
|
||||
"readerID": "mytest",
|
||||
"bookingTyp": 1,
|
||||
"loggedTime": "2024-09-05T08:51:12.670827Z",
|
||||
}
|
||||
```
|
||||
Antwort `200`
|
||||
```json
|
||||
{
|
||||
"cradID": "test_card",
|
||||
"readerID": "mytest",
|
||||
"bookingTyp": 1,
|
||||
"loggedTime": "2024-09-05T08:51:12.670827Z",
|
||||
"id": 6
|
||||
}
|
||||
```
|
||||
|
||||
### Neue Buchung [/time/new]
|
||||
#### [PUT] Anfrage
|
||||
Parameter:
|
||||
- cardID (string)
|
||||
- readerID (string)
|
||||
- bookingType (string)
|
||||
|
||||
Antwort `202` Akzeptiert und eingefügt
|
||||
```json
|
||||
{
|
||||
"cradID": "test_card",
|
||||
"readerID": "mytest",
|
||||
"bookingTyp": 1,
|
||||
"loggedTime": "2024-09-05T08:51:12.670827Z",
|
||||
"id": 6
|
||||
}
|
||||
```
|
||||
|
||||
Antwort `409` Konflikt
|
||||
Die vorherige Buchung am selben Tag hat den gleichen Buchungstyp
|
||||
|
||||
Reference in New Issue
Block a user