관리 클라이언트 목록 조회

GET /v1/management-clients · 권한 management-clients:read

환경의 관리 클라이언트 레코드를 커서 기반 페이지로 반환하며, 기본적으로 application_id 내림차순으로 정렬됩니다. 레코드는 management 유형 애플리케이션에 속하며, 관리 API에 대한 권한 상한과 IP 허용 목록을 담고 있습니다. 클라이언트의 서명 키는 이 리소스에 포함되지 않습니다. 이들은 /v1/applications/{application_id}/credentials에서 관리합니다. API 키만 이 엔드포인트를 호출할 수 있으며, 환경은 키에서 결정됩니다.

요청

매개변수 유형 필수 설명
limit integer 아니요 1~100, 기본값 20.
after string 아니요 list_metadata.after에서 얻은 커서. before와 함께 사용할 수 없습니다.
before string 아니요 list_metadata.before에서 얻은 커서.
order string 아니요 asc 또는 desc(기본값). 커서는 같은 order에서만 유효합니다.

응답

200 OK

{
  "data": [
    {
      "application_id": "app_01h455vb4pex5vsknk084sn02q",
      "permissions": ["users:read", "users:write"],
      "allowed_cidrs": ["203.0.113.0/24"]
    }
  ],
  "list_metadata": { "before": null, "after": null }
}

커서가 null이면 해당 방향에 더 이상 레코드가 없다는 뜻입니다. 전체 개수는 반환되지 않습니다. 애플리케이션을 삭제하면 해당 레코드도 제거됩니다. 애플리케이션이 이미 없는 레코드는 목록에 나타나지 않으며, 페이지가 그 레코드에 닿으면 제거됩니다. 따라서 after가 남아 있어도 페이지에 limit보다 적은 레코드가 들어 있을 수 있습니다. 커서를 계속 따라가십시오.

오류

HTTP code 발생 조건
400 invalid_cursor 커서 형식이 잘못되었거나 변조되었거나, 다른 환경 또는 다른 order용으로 발급되었습니다.
403 insufficient_permissions 자격 증명에 management-clients:read가 없거나 API 키가 아닙니다.
422 validation_failed 쿼리 매개변수가 올바르지 않습니다.

예제

curl "https://api.eu.keenauth.com/v1/management-clients?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

CLI: keenauth management-clients list --limit 20