Add instructions and endpoint documentation to README.md

This commit is contained in:
2022-04-24 02:06:33 +02:00
parent 60d78bcdac
commit 6800d4f07e

View File

@@ -1 +1,24 @@
# Bullet Hell Jam 2022 scoreboard server # Bullet Hell Jam 2022 scoreboard server
## Run the server
Edit .env (and docker-compose ports if necessary)
and run
```
$ docker-compose up
```
## Initialize database
Connect to DB using specified root credentials
Execute schema.sql to create tables and fields
Create new user `scoreboard` with the specified password and grant permissions `select, insert` on `scoreboard` table
## Endpoints
- /scores
- GET: returns all scores in descending order (LIMIT 10)
- POST: inserts a new score (Params: username, score, additional_data)
The endpoint takes content of type `application/x-www-form-urlencoded`
- `username` String of length <= 5
- `score` Integer
- `additional_data` String, optional (inteneded for potential metadata)