세션 상세 조회

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

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

요청

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

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

요청 헤더

Video Player Enhancement API에서 공통으로 사용하는 헤더에 대한 정보는 Video Player Enhancement 요청 헤더를 참조해 주십시오.

요청 쿼리 파라미터

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

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

요청 예시

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

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

응답

응답 형식을 설명합니다.

응답 바디

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

필드	타입	필수 여부	설명
`code`	String	-	응답 코드
`message`	String	-	응답 메시지
`result`	Array	-	세션 정보

`result`

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

필드	타입	필수 여부	설명
`startTime`	Array	-	재생 시작까지 걸린 시간
`user`	Array	-	세션 사용자 정보
`player`	Array	-	플레이어 정보
`error`	Array	-	오류 정보
`sessionLog`	Array	-	세션 로그 (플레이어 동작 사이클 로그)
`media`	Array	-	재생 소스 정보

`startTime`

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

필드	타입	필수 여부	설명
`playerStartTimeSum`	Integer	-	플레이어 준비 시간 (초)
`videoStartTimeSum`	Integer	-	재생 시작 시간 (초)
`totalStartTimeSum`	Integer	-	전체 재생 시간 (초)

`user`

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

필드	타입	필수 여부	설명
`os`	String	-	운영 체제 정보
`isp`	String	-	네트워크 망 정보
`nation`	String	-	국가 정보
`address`	String	-	위치 정보
`browser`	String	-	브라우저 정보
`ip`	String	-	IP 주소
`device`	String	-	플레이어 재생 환경 `PC,Mobile`\| `PC` \| `Mobile`
`screen`	String	-	화면 해상도
`lang`	String	-	언어 코드
`visitedPage`	String	-	재생된 페이지

`player`

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

필드	타입	필수 여부	설명
`playerName`	String	-	플레이어 이름
`playerVersion`	String	-	플레이어 버전
`playerType`	String	-	플레이어 구분
`playerUrl`	String	-	플레이어 도메인

`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 응답 상태 코드를 참조해 주십시오.

응답 예시

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

{
	"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"
			}
		]
	}
}