Management-Client abrufen

GET /v1/management-clients/{application_id} · Berechtigung management-clients:read

Gibt den Management-Client-Datensatz einer Anwendung zurück. Die Antwort enthält einen ETag-Header; senden Sie ihn als If-Match, um den Datensatz zu aktualisieren oder zu löschen. Nur ein API-Schlüssel kann diesen Endpunkt aufrufen.

Anfrage

Parameter In Beschreibung
application_id Pfad Anwendungs-ID (app_…).

Antwort

200 OK

{
  "application_id": "app_01h455vb4pex5vsknk084sn02q",
  "permissions": ["users:read", "users:write"],
  "allowed_cidrs": ["203.0.113.0/24"]
}

Fehler

HTTP code Wann
403 insufficient_permissions Der Berechtigungsnachweis hat nicht management-clients:read, oder es ist kein API-Schlüssel.
404 not_found Die Anwendung hat in dieser Umgebung keinen Datensatz.

Beispiel

curl -i https://api.eu.keenauth.com/v1/management-clients/app_01h455vb4pex5vsknk084sn02q \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth management-clients get app_01h455vb4pex5vsknk084sn02q (das ETag wird auf stderr ausgegeben).