Der Status mehrerer Mitglieder

GET /members/status

Der Status jeder Mitgliedsnummer in keys. Das Studio ruft diese Operation derzeit nicht auf.

Authentifizierung

appsolut_m2m (im Header x-api-key gesendet): Der „API-Schlüssel“, der in der Anbindung des Registers im Studio eingetragen ist, bei jedem Aufruf gesendet. Das Studio speichert ihn verschlüsselt und zeigt ihn nie wieder an. Antworten Sie auf einen falschen Schlüssel mit 401 oder 403.

Parameter

Name	Ort	Pflicht	Typ	Beschreibung
`keys`	Query-Parameter	Ja	string[]	Die nachzuschlagenden Mitgliedsnummern, der Parameter für jede wiederholt: `?keys=100001&keys=100002`. Beispiel: `["100001","100002"]`.
`x-tenant-id`	Header	Ja	string	Die „Mandanten-ID“, die in der Anbindung des Registers im Studio eingetragen ist, bei jedem Aufruf unverändert gesendet. Ihr Register kann damit die Organisationen unterscheiden, die es bedient. Beispiel: `pannoniqa`.
`x-custom-scope`	Header	Ja	string	Der „Scope“, der in der Anbindung des Registers im Studio eingetragen ist, bei jedem Aufruf unverändert gesendet. Ihr Register kann damit den Datenbestand wählen, aus dem es antwortet. Beispiel: `employees`.

Antworten

200

Ein Element pro gefundener Mitgliedsnummer.

Inhaltstyp: application/json

Feld	Typ	Pflicht	Beschreibung
`[].memberCode`	string	Ja	Die Mitgliedsnummer, die Kennung der Person in der Organisation.
`[].source`	string	Ja	Der Name Ihrer Datenquelle, etwa „SAP HR“.
`[].status`	object	Ja
`[].status.statusCode`	string	Ja	Der Status des Mitglieds im Register. Filter in der Mitgliedschaftsdefinition und in Communities können ihn prüfen. Erlaubte Werte: `active`, `inactive`, `pending`.

Beispiel

[
  {
    "memberCode": "100001",
    "source": "SAP HR",
    "status": {
      "statusCode": "active"
    }
  },
  {
    "memberCode": "100002",
    "source": "SAP HR",
    "status": {
      "statusCode": "active"
    }
  }
]

400

Das Register konnte die Anfrage nicht verarbeiten. Das Studio behandelt das Register dann als nicht erreichbar und liest den Inhalt nicht.

Inhaltstyp: text/plain

Typ: string

Beispiel

Bad request

401

Der API-Schlüssel ist falsch. Das Studio meldet die Zugangsdaten als abgelehnt (ebenso bei 403) und behandelt das Register als nicht erreichbar.

Inhaltstyp: text/plain

Typ: string

Beispiel

Unauthorized

Der Status mehrerer Mitglieder

GET /members/status

Der Status jeder Mitgliedsnummer in keys. Das Studio ruft diese Operation derzeit nicht auf.

Authentifizierung

appsolut_m2m (im Header x-api-key gesendet): Der „API-Schlüssel“, der in der Anbindung des Registers im Studio eingetragen ist, bei jedem Aufruf gesendet. Das Studio speichert ihn verschlüsselt und zeigt ihn nie wieder an. Antworten Sie auf einen falschen Schlüssel mit 401 oder 403.

Parameter

Name	Ort	Pflicht	Typ	Beschreibung
`keys`	Query-Parameter	Ja	string[]	Die nachzuschlagenden Mitgliedsnummern, der Parameter für jede wiederholt: `?keys=100001&keys=100002`. Beispiel: `["100001","100002"]`.
`x-tenant-id`	Header	Ja	string	Die „Mandanten-ID“, die in der Anbindung des Registers im Studio eingetragen ist, bei jedem Aufruf unverändert gesendet. Ihr Register kann damit die Organisationen unterscheiden, die es bedient. Beispiel: `pannoniqa`.
`x-custom-scope`	Header	Ja	string	Der „Scope“, der in der Anbindung des Registers im Studio eingetragen ist, bei jedem Aufruf unverändert gesendet. Ihr Register kann damit den Datenbestand wählen, aus dem es antwortet. Beispiel: `employees`.

Antworten

200

Ein Element pro gefundener Mitgliedsnummer.

Inhaltstyp: application/json

Feld	Typ	Pflicht	Beschreibung
`[].memberCode`	string	Ja	Die Mitgliedsnummer, die Kennung der Person in der Organisation.
`[].source`	string	Ja	Der Name Ihrer Datenquelle, etwa „SAP HR“.
`[].status`	object	Ja
`[].status.statusCode`	string	Ja	Der Status des Mitglieds im Register. Filter in der Mitgliedschaftsdefinition und in Communities können ihn prüfen. Erlaubte Werte: `active`, `inactive`, `pending`.

Beispiel

[
  {
    "memberCode": "100001",
    "source": "SAP HR",
    "status": {
      "statusCode": "active"
    }
  },
  {
    "memberCode": "100002",
    "source": "SAP HR",
    "status": {
      "statusCode": "active"
    }
  }
]

400

Das Register konnte die Anfrage nicht verarbeiten. Das Studio behandelt das Register dann als nicht erreichbar und liest den Inhalt nicht.

Inhaltstyp: text/plain

Typ: string

Beispiel

Bad request

401

Der API-Schlüssel ist falsch. Das Studio meldet die Zugangsdaten als abgelehnt (ebenso bei 403) und behandelt das Register als nicht erreichbar.

Inhaltstyp: text/plain

Typ: string

Beispiel

Unauthorized