---
title: "세션 상세 조회"
slug: "vpe-api-sessionrecent-uuid"
updated: 2026-10-22T10:47:44Z
published: 2026-10-22T10:47:44Z
canonical: "api-gov.ncloud-docs.com/vpe-api-sessionrecent-uuid"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 세션 상세 조회

Classic/VPC 환경에서 이용 가능합니다.

플레이어를 사용한 사용자의 세션에 대한 상세 정보를 조회합니다.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET | /v1/sessionRecent/{Session UUID} |

### 요청 헤더

Video Player Enhancement API에서 공통으로 사용하는 헤더에 대한 정보는 [Video Player Enhancement 요청 헤더](/docs/vpe-api-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `Session UUID` | String | Required | 유니크 사용자 번호 - UUID 형식 |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location --request GET 'https://ma-dashboard-api.vpe.gov-ntruss.com/v1/sessionRecent/{Session UUID}' \
--header 'x-api-key: {API Key}' \
--header 'x-project-id: {Project id}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `code` | String | - | 응답 코드 |
| `message` | String | - | 응답 메시지 |
| `result` | Object | - | 세션 정보 |
| `result.startTime` | Object | - | 재생 시작까지 걸린 시간 |
| `result.startTime.playerStartTimeSum` | Integer | - | 플레이어 준비 시간(초) |
| `result.startTime.videoStartTimeSum` | Integer | - | 재생 시작 시간(초) |
| `result.startTime.totalStartTimeSum` | Integer | - | 전체 재생 시간(초) |
| `result.user` | Object | - | 세션 사용자 정보 |
| `result.user.os` | String | - | 운영 체제 정보 |
| `result.user.isp` | String | - | 네트워크 망 정보 |
| `result.user.nation` | String | - | 국가 정보 |
| `result.user.address` | String | - | 위치 정보 |
| `result.user.browser` | String | - | 브라우저 정보 |
| `result.user.ip` | String | - | IP 주소 |
| `result.user.device` | String | - | 플레이어 재생 환경 - `PC,Mobile`\| `PC` \| `Mobile` |
| `result.user.screen` | String | - | 화면 해상도 |
| `result.user.lang` | String | - | 언어 코드 |
| `result.user.visitedPage` | String | - | 재생된 페이지 |
| `result.player` | Object | - | 플레이어 정보 |
| `result.player.playerName` | String | - | 플레이어 이름 |
| `result.player.playerVersion` | String | - | 플레이어 버전 |
| `result.player.playerType` | String | - | 플레이어 구분 |
| `result.player.playerUrl` | String | - | 플레이어 도메인 |
| `result.error` | Array | - | 오류 정보: [error](/docs/vpe-api-sessionrecent-uuid#error) |
| `result.sessionLog` | Array | - | 세션 로그 (플레이어 동작 사이클 로그): [sessionLog](/docs/vpe-api-sessionrecent-uuid#sessionLog) |
| `result.media` | Array | - | 재생 소스 정보: [media](/docs/vpe-api-sessionrecent-uuid#media) |

#### `error`

`error`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `errorCode` | Integer | - | 오류 코드 |
| `message` | String | - | 오류 메시지 |

#### `sessionLog`

`sessionLog`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `logDate` | Date | - | 세션 생성 일시 |
| `uuid` | String | - | 유니크 사용자 번호 - UUID 형식 |
| `videoTime` | String | - | 재생 시간 |
| `actionType` | String | - | 액션 타입: Media Analytics 사용량에 해당하는 이벤트 정보 - `player_start` \| `startup` \| `playing` \| `paused` \| `seeking` \| `rebuffering` \| `prev_tarck` \| `next_track` \| `ended` \| `error` - `player_start`: 플레이어 시작 (VPE 인증 성공 후 플레이어 재생 준비 상태) - `startup`: 재생 성공 (사용자가 재생 시도 후 영상의 첫 화면 재생) - `playing`: 재생 시간 (60초마다 이벤트 보고, 60초 이전 다른 이벤트 발생 시 즉시 보고) - `paused`: 정지 버튼 클릭 - `seeking`: 비디오 탐색, 해상도 변경 시 버퍼링 발생 - `rebuffering`: 재생 영상의 데이터 부족으로 버퍼링 발생 (`seeking` 경우 제외) - `prev_tarck`: 이전 영상 버튼 클릭 - `next_track`: 다음 영상 버튼 클릭 - `ended`: 영상 끝까지 시청 (반복 재생 설정 시 0초로 `seeking` 발생하여 `ended` 발생 안 함) - `error`: 오류 발생 |
| `actionDuration` | Integer | - | 완료까지 걸린 시간(초) |

#### `media`

`media`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `videoType` | String | - | 재생 소스 구분 - `VOD,LIVE` \| `VOD` \| `LIVE` - `VOD,LIVE`: VOD 비디오, LIVE 스트림 - `VOD`: VOD 비디오 - `LIVE`: LIVE 스트림 |
| `videoFormat` | String | - | 재생 소스 분류 |
| `duration` | Integer | - | 동영상 전체 길이 |
| `url` | String | - | 재생 소스 URL |
| `title` | String | - | 동영상 제목 |
| `logDate` | Date | - | 세션 생성 일시 |

### 응답 상태 코드

Video Player Enhancement API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Video Player Enhancement 응답 상태 코드](/docs/vpe-api-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

```
{
	"code": 200,
	"message": "sessionRecentDetail",
	"result": {
		"startTime": {
			"playerStartTimeSum": 0.008,
			"videoStartTimeSum": 0.413,
			"totalStartTimeSum": 0.421
		},
		"user": {
			"os": "Windows / 10",
			"isp": "SK Broadband Co Ltd",
			"nation": "Korea, Republic of",
			"address": "서울특별시 강남구 역삼2동",
			"browser": "Edge / 141.0.0.0",
			"ip": "***.***.***.***",
			"device": "PC",
			"screen": "1680x1050",
			"lang": "ko",
			"visitedPage": "/demo/scrollFloating"
		},
		"player": {
			"playerName": "vpe-guide-website",
			"playerVersion": "latest",
			"playerType": "VPE",
			"playerUrl": "https://vpe.*********.com"
		},
		"error": [],
		"sessionLog": [
			{
				"logDate": "2025-10-08 12:52:00",
				"logDateUnix": "1759895520830",
				"videoTime": 0,
				"watchingPercent": 0,
				"actionType": "player_start",
				"actionDuration": 0.008,
				"quality": "1080p",
				"errorCode": null,
				"errorMessage": null
			},
			{
				"logDate": "2025-10-08 12:52:01",
				"logDateUnix": "1759895521248",
				"videoTime": 0,
				"watchingPercent": 0,
				"actionType": "startup",
				"actionDuration": 0.413,
				"quality": "1080p",
				"errorCode": null,
				"errorMessage": null
			},
			{
				"logDate": "2025-10-08 12:52:02",
				"logDateUnix": "1759895522082",
				"videoTime": 0,
				"watchingPercent": 0,
				"actionType": "playing",
				"actionDuration": 0.834,
				"quality": "1080p",
				"errorCode": null,
				"errorMessage": null
			}
		],
		"media": [
			{
				"videoType": "VOD",
				"videoFormat": "hls",
				"duration": 91,
				"url": "https://*********.naverncp.com/hls/*********/endpoint/sample/221027_NAVER_Cloud_intro_Long_ver_AVC_,FHD_2Pass_30fps,HD_2Pass_30fps,SD_2Pass_30fps,.mp4.smil/master.m3u8",
				"title": "네이버클라우드 소개 영상",
				"logDate": "2025-10-08 12:52:01"
			}
		]
	}
}
```