Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Auszug
hiddentrue

Nuclos REST login: POST, JSON, username, password, JSESSIONID, cookie, 401, logout, DELETE, session.

globe with meridians Language: Deutsch · English

hammer and wrench 3. Login

Authenticate at the REST service – POST with JSON credentials, JSESSIONID cookie and logout via DELETE.

Status
colourPurple
titleHow-to
Status
colourBlue
titleDeveloper
Status
colourGreen
titleUpdated: Jul 2026
Status
colourGrey
titleapplies to Nuclos 4.2026.x

Panel
bgColor#F4F5F7

On this page

Inhalt
maxLevel2
minLevel2

Log in via POST to the root URL of the REST service (http://localhost:8080/nuclos-war/rest/). User name and password are passed as JSON.

Request

Codeblock
languagejson
{"username": "nuclos", "password": ""}

Required headers:

Codeblock
languagehttp
Accept: application/json
Content-Type: application/json

The response is a JSON object with the entry links (e.g. boMetas, menu).

Passing the session ID

All services (except a few such as login) require a valid session ID – otherwise the service responds with HTTP 401 (Unauthorized). The session ID is passed as the cookie JSESSIONID=xxx.

Warnung
titlesessionId header removed

In Nuclos 4.4.x/4.5.x the header sessionId was an alternative – from 4.6 it is no longer supported.

Logout

Same URL as login, via DELETE – invalidates the session ID (HTTP 200 if it was valid).

Related pages

gear 4. Reading business objects (BO)


Read BOs.

Open →

gear Example calls via shell


curl.

Open →