Seitenhistorie
Inhalt | ||
---|---|---|
|
Login
Der Login erfolgt auf
Codeblock |
---|
/ |
(ROOT URL des RESTful Service, z.B. http://localhost:8080/nuclos-war/rest/)
Per POST wird der Benutzername und Passwort als JSON Objekt übergeben.
Codeblock | ||
---|---|---|
| ||
{"username": "nuclos", "password": ""} |
Dabei müssen folgende Request-Header gesetzt werden:
Codeblock | ||
---|---|---|
| ||
Accept:application/json
Content-Type:application/json |
Als Response erhält man wieder ein JSON Objekt
Codeblock | ||
---|---|---|
| ||
{
"links": {
"boMetas": {
"href": "http://localhost:8080/nuclos-war/rest/bos",
"methods": [
"GET"
]
},
"menu": {
"href": "http://localhost:8080/nuclos-war/rest/meta/menu",
"methods": [
"GET"
]
},
"search": {
"href": "http://localhost:8080/nuclos-war/rest/data/search/{text}",
"methods": [
"GET"
]
},
"tasks": {
"href": "http://localhost:8080/nuclos-war/rest/meta/tasks",
"methods": [
"GET"
]
}
},
"locale": "en_US",
"sessionId": "07886B9397400D168EF2B49DBDB3F913",
"username": "nuclos"
} |
Mitgabe der Session ID
Jeder Service, bis auf wenige Ausnahmen (z.B. Login), benötigt eine Session ID. Wird keine Session ID übergeben, bzw. ist die Session ID ungültig, gibt der Service einen Fehler mit dem HTTP Status 401 (Unauthorized) zurück. Die Session ID kann entweder als Standard-Cookie oder als Http-Header-Parameter beim Aufruf des REST-Services übergeben werden. Der Key lautet "Cookie" und der Inhalt muss dem Schema "JSESSIONID=xxx" entsprechen, wobei xxx durch die aktuelle Session ID ersetzt werden muss.
Info |
---|
In den Nuclos Versionen 4.4.x und 4.5.x kann alternativ auch der Http-Header-Parameter "sessionId" verwendet werden, was allerdings ab Version 4.6 NICHT mehr möglich ist. |
Logout
Die URL ist identisch zum Login. Per DELETE invalidiert man die bestehende Session ID. Dieser Service gibt den HTTP Status 200 (OK) zurück, wenn die Session ID gültig war.
Ausführbares Beispiel
Siehe Beispielaufrufe per Shell