Sitzungsfunktionen - customX REST-Schnittstelle
Übersicht der Sitzungsfunktionen
⚙️ Verfügbar ab: Release 6
❗ Wichtige Änderung: Release 8.29
🧩 Dieser Artikel enthält Funktionalitäten einer oder mehr Zusatzoptionen
Login und gleichzeitigem Starten einer neuen Sitzung
Method Details
HTTP Method: POST
Method URI: API/Login
Response Format: JSON
Erforderlich: WAHR
Example POST URL:
http://localhost/CustomXApp/Api/Login
Example POST body:
{
"username": "Max",
"password": "geheim",
"culture": "de-DE"
}
Example response:
c009f9dc
Error response:
null
Erforderliche Parameter
| Parameter | Beschreibung | Verfügbar ab Release |
| username | customX Benutzername. Dieser Benutzer mus in der Konto-Verwaltung von customX bekannt sein. In Abhängigkeit des Regelwerks reicht es aus, ein Konto für den Aufruf anzulegen. Abfragen, Aussehen, usw. werden in der Regel durch Rollenparameter gesteuert. | |
| password | Passwort des customX Benutzerkontos. | |
| culture | Legt die Culture fest, die für die Darstellung im Webbrowser verwendet wird. Die Culture beeinflusst kulturspezifische Formatierungen, wie z. B. Datums- und Kalenderformate, Währungsdarstellungen sowie die Formatierung reeller Zahlen. Die Angabe erfolgt im Format <language code>[-<country/region code>], z. B. de-DE, en-US, de-CH. |
8.44 |
Antwortdetails
Die Antwort enthält entweder die ID der neu angelegten Sitzung oder null im Falle eines Fehlschlags.
Logout mit Beenden der Session
Method Details
HTTP Method: POST
Method URI: API/Logout
Response Format: JSON
Erforderlich: WAHR
Example POST URL:
http://localhost/CustomXApp/Api/Logout
Example POST body:
{
"sessionid": "c009f9dc"
}
Example response:
true
Erforderliche Parameter
| Parameter | Beschreibung |
| sessionid | ID einer aktiven Session |
Antwortdetails
Die Antwort lautet true für ein einfolgreiches Abmelden und false für einen Fehlschlag.