Die Mitgliedschaft des angemeldeten Frontend-Benutzers

Liest die Organisationsmitgliedschaft des Frontend-Benutzers, der beim aufrufenden Frontend angemeldet ist, um Formulare in seinem Namen vorauszufüllen und abzusenden. Status, Communities und Register sind das, was das Studio aus der letzten Mitgliedschaftsprüfung des Benutzers gespeichert hat, unter Anwendung der Kulanzregel. Nur die Mitgliedsdaten (memberData: Geburtsdatum, Telefon, Postanschrift) werden bei einer gültigen Mitgliedschaft live aus dem Register gelesen, mit dem die Mitgliedschaft verknüpft ist; das Studio speichert nichts davon und protokolliert dafür keine Mitgliedschaftsprüfung.

Nur ein internes Frontend darf diesen Endpunkt aufrufen, mit seinem Frontend-Schlüssel und dem Zugriffstoken des Benutzers aus Login with appsolut, ausgestellt für dieses Frontend (client_id) bei dieser Organisation (tenant_id). Der Benutzer braucht seine Frontend-Aktivierung für das Frontend und, falls er eine Organisationsmitgliedschaft hat, eine, die nicht deaktiviert ist. Ein Benutzer ohne Mitgliedschaft erhält status: null und keine Mitgliedsfelder.

Nie die Mitgliedsnummer, die Definitionsversion, Claims oder den Grund, warum eine Mitgliedschaft nicht gültig ist. 600 Anfragen pro Frontend-Benutzer und Stunde, danach 429: genug für jedes Vorausfüllen und Absenden, es stoppt nur eine außer Kontrolle geratene Schleife.

Authentifizierung

• Alle zusammen:
  • frontendKey (HTTP-Bearer-Token im Format ofk_<prefix>_<secret>): Der Frontend-Schlüssel des Frontends, im Studio auf der Seite des Frontends ausgestellt und einmal angezeigt: Authorization: Bearer ofk_…. Bis zu zwei sind gleichzeitig aktiv, sodass ein Schlüssel ohne Unterbrechung gewechselt werden kann.
  • frontendUserToken (im Header X-Frontend-User-Token gesendet): Das Zugriffstoken des angemeldeten Frontend-Benutzers aus Login with appsolut (das OAuth-Token, das Ihr Backend für ihn hält), unverändert. Nur zusätzlich zum Frontend-Schlüssel, nie an dessen Stelle.

Antworten

200

Die Mitgliedschaft des Benutzers. status: valid (eine gültige Mitgliedschaft, auch unter der Kulanzregel, solange das Register nicht antworten kann), not_valid (ein Register hat sie bei der letzten Prüfung abgelehnt), unavailable (gültig bei der letzten Prüfung, die ein Register erreicht hat, aber das Register hat seither 7 Tage lang nicht geantwortet) oder null (keine Organisationsmitgliedschaft). memberData sind die Mitgliedsdaten einer gültigen Mitgliedschaft; "unavailable", wenn ihr externes Register gerade nicht erreichbar ist oder nicht antworten kann, auch nicht innerhalb von 1,5 s (der Rest der Antwort gilt; fragen Sie später erneut); null, wenn die Mitgliedschaft nicht gültig ist oder das Register das Mitglied nicht mehr führt (der Eintrag ist weg oder deaktiviert, oder ein externes Register findet es nicht).

Inhaltstyp: application/json

Eine dieser Formen:

Mit Organisationsmitgliedschaft

Ohne Organisationsmitgliedschaft

Beispiel: Ein gültiges Mitglied eines internen Registers

{
  "status": "valid",
  "communities": [
    "Pensionistinnen und Pensionisten",
    "Gesamte Belegschaft"
  ],
  "register": "Pensionistinnen und Pensionisten",
  "lastVerifiedAt": "2026-10-24T08:15:00.000Z",
  "frontendsUsed": [
    {
      "name": "Pannoniqa Portal",
      "firstActivatedAt": "2026-09-01T07:30:00.000Z",
      "lastSignedInAt": "2026-10-24T08:15:00.000Z"
    }
  ],
  "memberData": {
    "birthDate": "1958-03-14",
    "phone": "+43 660 1234567",
    "address": {
      "street": "Beispielgasse 12",
      "zip": "7000",
      "city": "Eisenstadt"
    }
  }
}

Beispiel: Ein gültiges Mitglied eines externen Registers, das keine Telefonnummer führt

{
  "status": "valid",
  "communities": [
    "Aktive Belegschaft",
    "Gesamte Belegschaft"
  ],
  "register": "SAP HR",
  "lastVerifiedAt": "2026-10-24T08:15:00.000Z",
  "frontendsUsed": [
    {
      "name": "Pannoniqa App",
      "firstActivatedAt": "2026-10-02T18:00:00.000Z",
      "lastSignedInAt": "2026-10-24T08:15:00.000Z"
    },
    {
      "name": "Pannoniqa Portal",
      "firstActivatedAt": "2026-09-01T07:30:00.000Z",
      "lastSignedInAt": "2026-10-20T12:00:00.000Z"
    }
  ],
  "memberData": {
    "birthDate": "1979-02-02",
    "phone": null,
    "address": {
      "street": "Musterweg 3",
      "zip": "7100",
      "city": "Neusiedl am See"
    }
  }
}

Beispiel: Ein gültiges Mitglied, dessen Eintrag keine Mitgliedsdaten enthält

{
  "status": "valid",
  "communities": [
    "Aktive Belegschaft",
    "Gesamte Belegschaft"
  ],
  "register": "Betriebsrat",
  "lastVerifiedAt": "2026-10-24T08:15:00.000Z",
  "frontendsUsed": [
    {
      "name": "Pannoniqa Portal",
      "firstActivatedAt": "2026-09-01T07:30:00.000Z",
      "lastSignedInAt": "2026-10-24T08:15:00.000Z"
    }
  ],
  "memberData": {
    "birthDate": null,
    "phone": null,
    "address": null
  }
}

Beispiel: Ein gültiges Mitglied, dessen externes Register nicht antworten kann

{
  "status": "valid",
  "communities": [
    "Aktive Belegschaft",
    "Gesamte Belegschaft"
  ],
  "register": "SAP HR",
  "lastVerifiedAt": "2026-10-24T08:15:00.000Z",
  "frontendsUsed": [
    {
      "name": "Pannoniqa Portal",
      "firstActivatedAt": "2026-09-01T07:30:00.000Z",
      "lastSignedInAt": "2026-10-24T08:15:00.000Z"
    }
  ],
  "memberData": "unavailable"
}

Beispiel: Ein gültiges Mitglied, das sein Register nicht mehr führt

{
  "status": "valid",
  "communities": [
    "Gesamte Belegschaft"
  ],
  "register": "Pensionistinnen und Pensionisten",
  "lastVerifiedAt": "2026-10-24T08:15:00.000Z",
  "frontendsUsed": [
    {
      "name": "Pannoniqa Portal",
      "firstActivatedAt": "2026-09-01T07:30:00.000Z",
      "lastSignedInAt": "2026-10-24T08:15:00.000Z"
    }
  ],
  "memberData": null
}

Beispiel: Bei der letzten Prüfung abgelehnt

{
  "status": "not_valid",
  "communities": [],
  "register": "Pensionistinnen und Pensionisten",
  "lastVerifiedAt": "2026-08-30T10:00:00.000Z",
  "frontendsUsed": [
    {
      "name": "Pannoniqa Portal",
      "firstActivatedAt": "2026-08-01T09:00:00.000Z",
      "lastSignedInAt": "2026-10-20T12:00:00.000Z"
    }
  ],
  "memberData": null
}

Beispiel: Das Register hat 7 Tage lang nicht geantwortet

{
  "status": "unavailable",
  "communities": [],
  "register": null,
  "lastVerifiedAt": "2026-10-10T09:00:00.000Z",
  "frontendsUsed": [
    {
      "name": "Pannoniqa Portal",
      "firstActivatedAt": "2026-09-15T09:00:00.000Z",
      "lastSignedInAt": "2026-10-24T09:00:00.000Z"
    }
  ],
  "memberData": null
}

Beispiel: Angemeldet, keine Organisationsmitgliedschaft

{
  "status": null,
  "frontendsUsed": [
    {
      "name": "Pannoniqa Portal",
      "firstActivatedAt": "2026-10-24T09:00:00.000Z",
      "lastSignedInAt": "2026-10-24T09:00:00.000Z"
    }
  ]
}

401

Kein Frontend-Schlüssel, oder einer, der fehlerhaft, unbekannt oder widerrufen ist, oder der Schlüssel eines getrennten Frontends; oder das Frontend ist extern; oder kein Benutzertoken, oder eines, das sich nicht verifizieren lässt, abgelaufen ist, einem Studio-Benutzer, einem anderen Frontend oder einer anderen Organisation gehört; oder die Frontend-Aktivierung des Benutzers fehlt, oder seine Mitgliedschaft ist deaktiviert. Jeder Fall erhält dieselbe Antwort.

Header

Inhaltstyp: application/json

Beispiel: Nicht authentifiziert

{
  "error": "unauthenticated"
}

429

Mehr als 600 Anfragen für diesen Frontend-Benutzer in der Stunde, die mit seiner ersten gezählten Anfrage begonnen hat. Abgewiesene Anfragen werden nicht gezählt. Es gibt kein Retry-After.

Inhaltstyp: application/json

Beispiel: Ratenlimit erreicht

{
  "error": "rate_limited"
}

503

Das Studio selbst ist ausgefallen. Versuchen Sie es später erneut; Schlüssel und Token sind in Ordnung.

Inhaltstyp: application/json

Beispiel: Das Studio ist nicht verfügbar

{
  "error": "unavailable"
}