GET Firmenverzeichnis und Audit lesen
/api/v1/enterprise/connections/{connection}/state
Firmenverzeichnis und Audit lesen. Die Owner-Konfiguration benötigt eine frische aktionsgebundene Mailbestätigung. Testen Sie die Konfiguration vor der Aktivierung einer SSO-Pflicht. Persönliche und andere Firmenzugänge bleiben unabhängig.
Auf dieser Seite
Zugriff und Rechte
Firmenverzeichnis und Audit lesen. Die Owner-Konfiguration benötigt eine frische aktionsgebundene Mailbestätigung. Testen Sie die Konfiguration vor der Aktivierung einer SSO-Pflicht. Persönliche und andere Firmenzugänge bleiben unabhängig.
Browsersitzung: Cookie __Host-mb_session.
Parameter und Header
| Feld | Position | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|---|
| connection | Pfad | string; {"format":"uuid"} | Ja | Kennung der Unternehmensverbindung. |
| identities_q | URL-Parameter | string | Nein | Suche in Namen und E-Mail-Adressen. |
| identities_cursor | URL-Parameter | string | Nein | Undurchsichtiger Cursor aus der vorherigen Seite. |
| identities_sort | URL-Parameter | string | Nein | Sortierung: name_asc oder name_desc. |
| groups_q | URL-Parameter | string | Nein | Suche in Namen und E-Mail-Adressen. |
| groups_cursor | URL-Parameter | string | Nein | Undurchsichtiger Cursor aus der vorherigen Seite. |
| groups_sort | URL-Parameter | string | Nein | Sortierung: name_asc oder name_desc. |
| requests_q | URL-Parameter | string | Nein | Suche in Namen und E-Mail-Adressen. |
| requests_cursor | URL-Parameter | string | Nein | Undurchsichtiger Cursor aus der vorherigen Seite. |
| requests_sort | URL-Parameter | string | Nein | Sortierung: name_asc oder name_desc. |
| audit_q | URL-Parameter | string | Nein | Suche in Namen und E-Mail-Adressen. |
| audit_cursor | URL-Parameter | string | Nein | Undurchsichtiger Cursor aus der vorherigen Seite. |
| audit_sort | URL-Parameter | string | Nein | Sortierung: name_asc oder name_desc. |
Anfragekörper
Kein Anfragekörper.
Antworten
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
application/json
| Feld | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|
| $ | object | Ja | — |
Wiederholungen und asynchrone Aufträge
Für diese Änderung gibt es keine allgemeine Wiederholungsgarantie. Prüfen Sie bei unklarer Antwort den betroffenen Eintrag, bevor Sie es erneut versuchen. Beachten Sie Wartezeiten aus Retry-After und fordern Sie abgelaufene Anmelde- oder Aktionscodes neu an.
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 --proto "=https" --tlsv1.2 --silent --show-error --max-time 10 --output /dev/null --write-out "%{http_code}\n" \
--request GET \
--header @"$HOME/.config/metribeacon/headers.txt" \
"https://metribeacon.com/api/v1/enterprise/connections/{connection}/state"
import json
from pathlib import Path
from urllib.request import Request, HTTPRedirectHandler, build_opener
from urllib.error import HTTPError
config = Path.home() / ".config/metribeacon"
headers = json.loads((config / "headers.json").read_text())
body = None
request = Request("https://metribeacon.com/api/v1/enterprise/connections/{connection}/state", data=body, headers=headers, method="GET")
class NoRedirect(HTTPRedirectHandler):
def redirect_request(self, request, fp, code, message, headers, target):
return None
try:
with build_opener(NoRedirect()).open(request, timeout=10) as response:
print(response.status)
except HTTPError as error:
print(error.code)
error.close()
import { readFile } from "node:fs/promises";
import { homedir } from "node:os";
import { join } from "node:path";
const config = join(homedir(), ".config/metribeacon");
const headers = JSON.parse(await readFile(join(config, "headers.json"), "utf8"));
const response = await fetch("https://metribeacon.com/api/v1/enterprise/connections/{connection}/state", {
method: "GET", headers, redirect: "manual",
signal: AbortSignal.timeout(10000),
});
console.log(response.status);
await response.body?.cancel();
package main
import (
"encoding/json"
"fmt"
"net/http"
"os"
"path/filepath"
"time"
)
func main() {
home, err := os.UserHomeDir(); if err != nil { panic("local configuration unavailable") }
config := filepath.Join(home, ".config/metribeacon")
raw, err := os.ReadFile(filepath.Join(config,"headers.json")); if err != nil { panic("local headers unavailable") }
var headers map[string]string
if json.Unmarshal(raw,&headers) != nil { panic("invalid local headers") }
request, err := http.NewRequest("GET","https://metribeacon.com/api/v1/enterprise/connections/{connection}/state",nil)
if err != nil { panic("request unavailable") }
for key,value := range headers { request.Header.Set(key,value) }
client := &http.Client{Timeout:10*time.Second,CheckRedirect:func(*http.Request,[]*http.Request)error{return http.ErrUseLastResponse}}
response, err := client.Do(request); if err != nil { panic("request failed; credentials and response omitted") }
defer response.Body.Close()
fmt.Println(response.StatusCode)
}
Verwandte Anleitungen
- HTTP-API, OAuth und MCP
Finden Sie die Nutzer-API-Endpunkte mit Rechten, Feldern, Beispielen und Antwortformaten.
- GET Unternehmensverbindung lesen
Unternehmensverbindung lesen. Die Owner-Konfiguration benötigt eine frische aktionsgebundene Mailbestätigung. Testen Sie die Konfiguration vor der Aktivierung einer SSO-Pflicht. Persönliche und andere Firmenzugänge bleiben unabhängig.
- PUT SSO-Konfigurationsentwurf speichern
SSO-Konfigurationsentwurf speichern. Die Owner-Konfiguration benötigt eine frische aktionsgebundene Mailbestätigung. Testen Sie die Konfiguration vor der Aktivierung einer SSO-Pflicht. Persönliche und andere Firmenzugänge bleiben unabhängig.
- DELETE Unternehmensverbindung löschen
Unternehmensverbindung löschen. Die Owner-Konfiguration benötigt eine frische aktionsgebundene Mailbestätigung. Testen Sie die Konfiguration vor der Aktivierung einer SSO-Pflicht. Persönliche und andere Firmenzugänge bleiben unabhängig.