엔티티 세부 정보 API

개요

엔티티 세부 정보 API는 고유 식별자를 알고 있을 때 특정 엔티티에 대한 포괄적인 정보를 가져올 수 있게 해주는 RESTful 엔드포인트입니다. 이 엔드포인트는 보안 사고를 조사하거나 사용자 행동 패턴을 분석하는 등, 알려진 대상에 대한 상세한 정보가 필요한 경우에 특히 유용합니다.

GET /api/entity/<entity_id>이 API는.을 통해 액세스할 수 있습니다.

경로 매개변수

이 API는 다음 경로 매개변수를 요구합니다:

응답 구조

이 API는 요청된 엔티티에 대한 다음을 포함한 상세 정보를 반환합니다:

• 엔티티 ID
• 관련 사용자 이름
• 현재 위험 점수
• 최신 위험 점수
• 엔티티 활동 타임스탬프
• 엔티티와 관련된 추가 속성

응답 예시

다음 예시는 엔티티에 대한 일반적인 API 응답을 보여줍니다:

{
  "risk_threshold": 50.0,
  "entities": [
    {
      "entity_id": 12345,
      "username": "john.doe",
      "risk_score": 78.5,
      "latest_risk": 82.0,
      "first_seen": "2026-05-10T08:15:00Z",
      "last_seen": "2026-06-15T14:30:00Z"
    }
  ]
}

응답 항목은 다음과 같습니다:

• risk_threshold는 쿼리에 적용되는 유효한 위험 임계값을 나타냅니다.
• entities에는 요청된 엔티티의 세부 정보가 담긴 배열이 포함되어 있습니다.
• entity_id는 엔티티를 식별하는 고유 식별자입니다.
• username은 해당 엔티티와 연결된 사용자 이름입니다.
• risk_score는 해당 엔티티의 현재 위험 점수를 나타냅니다.
• latest_risk는 해당 엔티티에 대해 계산된 가장 최근의 위험 점수를 표시합니다.
• first_seen은 해당 엔티티가 시스템에서 처음 관측된 시점을 나타냅니다.
• last_seen은 해당 엔티티의 가장 최근 활동 타임스탬프를 표시합니다.

오류 처리

이 API는 요청 결과를 나타내기 위해 표준 HTTP 상태 코드를 반환합니다: