From e7f0effd8f80641933b3c1be915b121ce58eacec Mon Sep 17 00:00:00 2001 From: alex <alex@alexloehr.net> Date: Mon, 26 May 2025 14:46:17 +0000 Subject: [PATCH] update doc --- README.md | 38 +++++++++++++++++++++++++++++++++++++- 1 files changed, 37 insertions(+), 1 deletions(-) diff --git a/README.md b/README.md index aa3e813..a01a5c8 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,12 @@ ## Setup +### Env und Settings + +Als Erstes wird die ENV Variable "NODE_ENV" gebraucht. Diese muss gesetzt sein. +Je nach ENV (dev, test, prod, ...) muss dann auch die settings Datei angepasst werden. + + ### Service Der REST-Service an sich muss auf dem gleichen Rechner laufen auf dem auch die ILIAS DB läuft (ansonsten die Config anpassen). @@ -28,4 +34,34 @@ Apache muss als Proxy für globus-ilias-rest fungieren und Verbindungen an diesen weiterreichen. -todo +__ACHTUNG__ +Der Service __muss__ unter https laufen. Ansonsten kann das AUTH-TOKEN ausgelesen werden. + +TODO + + + +## Usage + +Es wird ein Auth-Token gebraucht um den Service zu benutzen. Dieses wird in settings.js definiert. + +Dann kann der Service angesprochen werden (test mit curl): + + curl localhost:4101/users?token=AUTHTOKEN + +Die Antwort prettyfeien: + + curl localhost:4101/users?token=AUTHTOKEN | jq . + + + +### Routes + +Verfügbare Routen sind: + + GET /users + GET /users/count + GET /user/login/:login + GET /user/userId/:userId + + -- Gitblit v1.8.0