管理クライアントの取得
GET /v1/management-clients/{application_id} · 権限 management-clients:read
1 つのアプリケーションの管理クライアントのレコードを返します。レスポンスには ETag ヘッダーが含まれます。レコードを更新または削除するときは、それを If-Match として送ってください。このエンドポイントを呼び出せるのは API キーだけです。
リクエスト
| パラメータ | 位置 | 説明 |
|---|---|---|
application_id |
パス | アプリケーション ID(app_…)。 |
レスポンス
200 OK
{
"application_id": "app_01h455vb4pex5vsknk084sn02q",
"permissions": ["users:read", "users:write"],
"allowed_cidrs": ["203.0.113.0/24"]
}
エラー
| HTTP | code | 発生条件 |
|---|---|---|
| 403 | insufficient_permissions |
資格情報に management-clients:read がない、または API キーではありません。 |
| 404 | not_found |
このアプリケーションにはこの環境でレコードがありません。 |
例
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(ETag は stderr に出力されます)。