Endpoints / login

login

Login eines E-PAT-Benutzers (mobile/SSO-Integration)

Mobile-Login: prüft Benutzername und Passwort gegen den regulären E-PAT-Login. Für mobile Clients und SSO-Integrationen.

HTTP Request

POST https://dev.vitabyte.ch/v1/system/login
Auth basicAuth apiKey

Request Parameters

Parameter Pflicht Typ Beispiel / Default
username required string
password required string

Response Parameters

Envelope-Sonderfall: kein result, kein msg — nur status und code. status entspricht exakt code === "SUCCESS"; andere Codes (z. B. INVALID_CREDENTIALS) liefern status: false bei HTTP 200. Zusätzlich wird ein Cookie epat_refreshtoken gesetzt.

Field Typ Beschreibung
status boolean true, wenn code gleich SUCCESS ist
code string Ergebniscode, z. B. SUCCESS oder INVALID_CREDENTIALS

Demo

Beispiel-Response handgepflegt — die OpenAPI-Spec liefert für diesen Endpoint noch kein Response-Example.

POST https://dev.vitabyte.ch/v1/system/login Erfolgreicher Login
Payload
{
    "username": "user@example.com",
    "password": "secret"
}
Response
{
    "status": true,
    "code": "SUCCESS"
}
POST https://dev.vitabyte.ch/v1/system/login Falsche Zugangsdaten
Response
{
    "status": false,
    "code": "INVALID_CREDENTIALS"
}