GET Mitglieder und Einladungen des Arbeitsbereichs auflisten

/api/v1/workspaces/{id}/members

Arbeitsbereich-Rollen und Verwaltungsscopes werden gemeinsam geprüft. Der Owner trägt gemeinsame Kontingente. Einladungen gelten 48 Stunden und können nur mit der eingeladenen, bestätigten E-Mail-Adresse angenommen werden. Mitgliedschaftsänderungen benötigen eine aktionsgebundene Mailbestätigung; dieselbe Bestätigung mit identischer Nutzlast liefert das gespeicherte Ergebnis ohne erneuten Verbrauch. Der Entzug von Editorrechten widerruft ausgegebene Zugangsschlüssel; Mitgliedsentfernung bricht deren Archivjobs ab. Rechte zur Statusseiten-Veröffentlichung bleiben getrennt.

Auf dieser Seite

Zugriff und Rechte

Browsersitzung: Cookie __Host-mb_session.

Maschinen-Verwaltungszugang in Authorization: Bearer. Beachten Sie die von der Operation benötigten Berechtigungen (Scopes).

Parameter und Header

Feld	Position	Typ und Grenzen	Erforderlich	Bedeutung
id	Pfad	string; {"format":"uuid"}	Ja	Die konkrete Arbeitsbereich-, Mitglied- oder Einladungskennung. Fremde oder nicht geteilte Arbeitsbereich-Kennungen gewähren keinen Zugriff.

Anfragekörper

Kein Anfragekörper.

Antworten

application/json

Feld	Typ und Grenzen	Erforderlich	Bedeutung
$	object; {"additionalProperties":true}	Ja	—

Stabile Fehlercodes
unauthorized
invalid_credential

application/problem+json

Feld	Typ und Grenzen	Erforderlich	Bedeutung
$	Problem	Ja	—
$.code	string	Ja	Stabiler maschinenlesbarer Fehlercode
$.detail	string	Ja	Kurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instance	string	Ja	Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.message	string	Ja	Vorübergehend für bestehende Clients gleich detail
$.message_key	string	Ja	Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_params	object; {"additionalProperties":true}	Ja	Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_id	string; {"pattern":"^[0-9a-f]{32}$"}	Ja	Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.status	integer; {"maximum":599,"minimum":400}	Ja	—
$.title	string	Ja	Lokalisierte HTTP-Statusbezeichnung
$.type	string; {"const":"about:blank"}	Ja	—

Stabile Fehlercodes
forbidden
csrf
invalid_origin
workspace_scope
confirmation_required
invalid_confirmation

application/problem+json

Feld	Typ und Grenzen	Erforderlich	Bedeutung
$	Problem	Ja	—
$.code	string	Ja	Stabiler maschinenlesbarer Fehlercode
$.detail	string	Ja	Kurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instance	string	Ja	Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.message	string	Ja	Vorübergehend für bestehende Clients gleich detail
$.message_key	string	Ja	Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_params	object; {"additionalProperties":true}	Ja	Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_id	string; {"pattern":"^[0-9a-f]{32}$"}	Ja	Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.status	integer; {"maximum":599,"minimum":400}	Ja	—
$.title	string	Ja	Lokalisierte HTTP-Statusbezeichnung
$.type	string; {"const":"about:blank"}	Ja	—

Stabile Fehlercodes
not_found

application/problem+json

Feld	Typ und Grenzen	Erforderlich	Bedeutung
$	Problem	Ja	—
$.code	string	Ja	Stabiler maschinenlesbarer Fehlercode
$.detail	string	Ja	Kurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instance	string	Ja	Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.message	string	Ja	Vorübergehend für bestehende Clients gleich detail
$.message_key	string	Ja	Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_params	object; {"additionalProperties":true}	Ja	Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_id	string; {"pattern":"^[0-9a-f]{32}$"}	Ja	Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.status	integer; {"maximum":599,"minimum":400}	Ja	—
$.title	string	Ja	Lokalisierte HTTP-Statusbezeichnung
$.type	string; {"const":"about:blank"}	Ja	—

Stabile Fehlercodes
already_invited
version_conflict
idempotency_conflict

application/problem+json

Feld	Typ und Grenzen	Erforderlich	Bedeutung
$	Problem	Ja	—
$.code	string	Ja	Stabiler maschinenlesbarer Fehlercode
$.detail	string	Ja	Kurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instance	string	Ja	Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.message	string	Ja	Vorübergehend für bestehende Clients gleich detail
$.message_key	string	Ja	Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_params	object; {"additionalProperties":true}	Ja	Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_id	string; {"pattern":"^[0-9a-f]{32}$"}	Ja	Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.status	integer; {"maximum":599,"minimum":400}	Ja	—
$.title	string	Ja	Lokalisierte HTTP-Statusbezeichnung
$.type	string; {"const":"about:blank"}	Ja	—

Stabile Fehlercodes
invalid_input
invalid_token
invalid_reference
invalid_action

application/problem+json

Feld	Typ und Grenzen	Erforderlich	Bedeutung
$	Problem	Ja	—
$.code	string	Ja	Stabiler maschinenlesbarer Fehlercode
$.detail	string	Ja	Kurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instance	string	Ja	Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.message	string	Ja	Vorübergehend für bestehende Clients gleich detail
$.message_key	string	Ja	Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_params	object; {"additionalProperties":true}	Ja	Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_id	string; {"pattern":"^[0-9a-f]{32}$"}	Ja	Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.status	integer; {"maximum":599,"minimum":400}	Ja	—
$.title	string	Ja	Lokalisierte HTTP-Statusbezeichnung
$.type	string; {"const":"about:blank"}	Ja	—

Stabile Fehlercodes
member_limit
rate_limited

application/problem+json

Feld	Typ und Grenzen	Erforderlich	Bedeutung
$	Problem	Ja	—
$.code	string	Ja	Stabiler maschinenlesbarer Fehlercode
$.detail	string	Ja	Kurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instance	string	Ja	Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.message	string	Ja	Vorübergehend für bestehende Clients gleich detail
$.message_key	string	Ja	Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_params	object; {"additionalProperties":true}	Ja	Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_id	string; {"pattern":"^[0-9a-f]{32}$"}	Ja	Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.status	integer; {"maximum":599,"minimum":400}	Ja	—
$.title	string	Ja	Lokalisierte HTTP-Statusbezeichnung
$.type	string; {"const":"about:blank"}	Ja	—

Stabile Fehlercodes
unavailable
feature_unavailable

application/problem+json

Feld	Typ und Grenzen	Erforderlich	Bedeutung
$	Problem	Ja	—
$.code	string	Ja	Stabiler maschinenlesbarer Fehlercode
$.detail	string	Ja	Kurze lokalisierte Erklärung ohne interne Fehlerdaten
$.instance	string	Ja	Einmalige relative Kennung /api/v1/requests/{request_id}; keine abrufbare Ressource
$.message	string	Ja	Vorübergehend für bestehende Clients gleich detail
$.message_key	string	Ja	Stabiler Übersetzungsschlüssel für einen Sprachwechsel der Anzeige ohne neue Anfrage
$.message_params	object; {"additionalProperties":true}	Ja	Benannte, sicher ausgegebene Meldungsparameter; kein beliebiges HTML
$.request_id	string; {"pattern":"^[0-9a-f]{32}$"}	Ja	Vom Server erzeugte Diagnosekennung. Enthält kein Logintoken und keine Zugangsdaten.
$.status	integer; {"maximum":599,"minimum":400}	Ja	—
$.title	string	Ja	Lokalisierte HTTP-Statusbezeichnung
$.type	string; {"const":"about:blank"}	Ja	—

Wiederholungen und asynchrone Aufträge

Diese Operation liest oder prüft, ohne eine Ressourcenänderung anzuwenden. Beachten Sie Ratenlimits und Zugangslaufzeiten.

Anfragebeispiele

Ersetzen Sie Demokennungen, Zeitstempel und Platzhalter durch eigene Werte. Behalten Sie bei Wiederholungen Kennungen, Zeit und Inhalt bei. Diese Beispiele führen auf der Seite keine Anfragen aus.

Halten Sie Anmeldelinks, Codes, Cookies und Schlüssel privat. Schreiben Sie sie nicht in Logs und teilen Sie sie nicht in Hilfeanfragen.

curl --fail-with-body --request GET --header @"$HOME/.config/metribeacon/headers.txt" "https://metribeacon.com/api/v1/workspaces/00000000-0000-4000-8000-000000000001/members"

import json, os, urllib.request
request = urllib.request.Request("https://metribeacon.com/api/v1/workspaces/00000000-0000-4000-8000-000000000001/members", method="GET", headers={"Cookie": os.environ["MB_COOKIE"], "X-CSRF-Token": os.environ["MB_CSRF"], "Content-Type": "application/json"}, data=None)
with urllib.request.urlopen(request, timeout=30) as response:
    print(json.load(response))

const response = await fetch("https://metribeacon.com/api/v1/workspaces/00000000-0000-4000-8000-000000000001/members", {method: "GET", credentials: "same-origin", headers: {"Content-Type": "application/json", "X-CSRF-Token": csrfToken}});
console.log(response.status, await response.json());

package main
import ("fmt"; "net/http"; "os"; "strings"; "time")
func main() { client := &http.Client{Timeout:30*time.Second}; request, err := http.NewRequest("GET", "https://metribeacon.com/api/v1/workspaces/00000000-0000-4000-8000-000000000001/members", strings.NewReader("")); if err != nil { panic(err) }; request.Header.Set("Cookie", os.Getenv("MB_COOKIE")); request.Header.Set("X-CSRF-Token",os.Getenv("MB_CSRF"));request.Header.Set("Content-Type","application/json");response,err:=client.Do(request);if err!=nil{panic(err)};defer response.Body.Close();fmt.Println(response.StatusCode) }

HTTP-API, OAuth und MCP
Finden Sie die Nutzer-API-Endpunkte mit Rechten, Feldern, Beispielen und Antwortformaten.
PATCH Ein Arbeitsbereich-Mitglied ändern oder entfernen
Arbeitsbereich-Rollen und Verwaltungsscopes werden gemeinsam geprüft. Der Owner trägt gemeinsame Kontingente. Einladungen gelten 48 Stunden und können nur mit der eingeladenen, bestätigten E-Mail-Adresse angenommen werden. Mitgliedschaftsänderungen benötigen eine aktionsgebundene Mailbestätigung; dieselbe Bestätigung mit identischer Nutzlast liefert das gespeicherte Ergebnis ohne erneuten Verbrauch. Der Entzug von Editorrechten widerruft ausgegebene Zugangsschlüssel; Mitgliedsentfernung bricht deren Archivjobs ab. Rechte zur Statusseiten-Veröffentlichung bleiben getrennt.
GET Mitgliedschaftsänderungen des Arbeitsbereichs lesen
Arbeitsbereich-Rollen und Verwaltungsscopes werden gemeinsam geprüft. Der Owner trägt gemeinsame Kontingente. Einladungen gelten 48 Stunden und können nur mit der eingeladenen, bestätigten E-Mail-Adresse angenommen werden. Mitgliedschaftsänderungen benötigen eine aktionsgebundene Mailbestätigung; dieselbe Bestätigung mit identischer Nutzlast liefert das gespeicherte Ergebnis ohne erneuten Verbrauch. Der Entzug von Editorrechten widerruft ausgegebene Zugangsschlüssel; Mitgliedsentfernung bricht deren Archivjobs ab. Rechte zur Statusseiten-Veröffentlichung bleiben getrennt.
POST Ein verifiziertes Konto in einen Arbeitsbereich einladen
Arbeitsbereich-Rollen und Verwaltungsscopes werden gemeinsam geprüft. Der Owner trägt gemeinsame Kontingente. Einladungen gelten 48 Stunden und können nur mit der eingeladenen, bestätigten E-Mail-Adresse angenommen werden. Mitgliedschaftsänderungen benötigen eine aktionsgebundene Mailbestätigung; dieselbe Bestätigung mit identischer Nutzlast liefert das gespeicherte Ergebnis ohne erneuten Verbrauch. Der Entzug von Editorrechten widerruft ausgegebene Zugangsschlüssel; Mitgliedsentfernung bricht deren Archivjobs ab. Rechte zur Statusseiten-Veröffentlichung bleiben getrennt.

Zugriff und Rechte

Parameter und Header

Anfragekörper

Antworten

Wiederholungen und asynchrone Aufträge

Anfragebeispiele

Verwandte Anleitungen