Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung | ||
rest.php [2017/01/09 05:58] – gelöscht lwsystems | rest.php [2019/02/04 07:54] (aktuell) – [Session Request] lwsystems | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
+ | ====== rest.php ====== | ||
+ | |||
+ | * REST-Frontend mit Benutzer-Authentisierung | ||
+ | * Authentisierung per HTTP BASIC Auth oder Session-Cookie | ||
+ | * Jeder BASIC AUTH Request eröffnet eine Session und liefert einen Cookie zurück | ||
+ | * Dokumentation des [[REST API]] | ||
+ | |||
+ | |||
+ | ====== Authentisierung ====== | ||
+ | |||
+ | ===== HTTP BASIC Auth ===== | ||
+ | |||
+ | Hier wird der Request bei erfolgreicher Authentisierung ausgeführt. | ||
+ | Der Client muss Informationen wie das Archiv kennen. | ||
+ | |||
+ | <code bash> | ||
+ | curl -u admin: | ||
+ | --data start=0 \ | ||
+ | --data limit=20 \ | ||
+ | --data archive=BennoContainer \ | ||
+ | --data ' | ||
+ | -D - -k https:// | ||
+ | </ | ||
+ | |||
+ | ===== Session ===== | ||
+ | |||
+ | Ab der Benno Web Version 2.2.2 besteht auch die Möglichkeit der Authentisierung per Session-Id. | ||
+ | |||
+ | ==== Session erstellen ==== | ||
+ | |||
+ | Bei erfolgreichem Login wird ein User-Objekt mit den Userdaten und " | ||
+ | Das Attribut //archive// ist ein Array mit den Archiven, auf die der User Zugriff hat. | ||
+ | |||
+ | <code bash> | ||
+ | curl -D - -k ' | ||
+ | |||
+ | HTTP/1.1 200 OK | ||
+ | Date: Tue, 22 Nov 2016 14:24:11 GMT | ||
+ | Server: Apache/ | ||
+ | X-Powered-By: | ||
+ | Set-Cookie: BENNOSID=c223e75ohpq5u1i0j9hhv36n60; | ||
+ | Expires: Thu, 19 Nov 1981 08:52:00 GMT | ||
+ | Cache-Control: | ||
+ | Pragma: no-cache | ||
+ | Content-Length: | ||
+ | Content-Type: | ||
+ | |||
+ | {" | ||
+ | </ | ||
+ | |||
+ | ==== Search Request ==== | ||
+ | |||
+ | <code bash> | ||
+ | curl --cookie BENNOSID=c223e75ohpq5u1i0j9hhv36n60 \ | ||
+ | --data start=0 \ | ||
+ | --data limit=20 \ | ||
+ | --data archive=BennoContainer \ | ||
+ | --data ' | ||
+ | -D - -k https:// | ||
+ | </ | ||
+ | |||