세션 최근 목록 조회

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

플레이어를 사용한 사용자의 최근 세션 100개를 조회합니다. 조회 시작 시점과 종료 시점 간의 간격에 따라 데이터 인터벌이 달라집니다.

시작 시점과 종료 시점 간격	인터벌
1일 이하	5분 단위
2일 이상	1일 단위

요청

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

메서드	URI
GET	/v1/sessionRecent

요청 헤더

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

요청 쿼리 파라미터

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

필드	타입	필수 여부	설명
`device`	String	Optional	플레이어 재생 환경 `PC,Mobile` (기본값)\| `PC` \| `Mobile`
`videoType`	String	Optional	재생 소스 구분 `VOD,LIVE` (기본값) \| `VOD` \| `LIVE` `VOD,LIVE`: VOD 비디오, LIVE 스트림 `VOD`: VOD 비디오 `LIVE`: LIVE 스트림
`startDate`	Date	Optional	조회 시작 일시 날짜 형식(UTC)
`endDate`	Date	Optional	조회 종료 일시 날짜 형식(UTC)
`limit`	Integer	Optional	세션 수 N~100

요청 예시

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

curl --location --request GET 'https://ma-dashboard-api.vpe.naverncp.com/v1/sessionRecent?device=PC,Mobile&videoType=VOD,LIVE' \
--header 'x-api-key: {API Key}' \
--header 'x-project-id: {Project id}'

응답

응답 형식을 설명합니다.

응답 바디

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

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

`result`

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

필드	타입	필수 여부	설명
`no`	Integer	-	번호
`logDate`	Date	-	세션 생성 일시
`uuid`	String	-	유니크 사용자 번호 UUID 형식
`origin`	String	-	호출 도메인
`os`	String	-	운영 체제 정보
`device`	String	-	플레이어 재생 환경 `PC,Mobile` \| `PC` \| `Mobile`
`totalStartTime`	Integer	-	재생 완료 보고까지 걸린 시간 (초)
`rebufferingTime`	Integer	-	버퍼링 시간(초)
`playingTime`	Integer	-	재생 시간 (초)
`isError`	Boolean	-	오류 여부 `true` \| `false` `true`: 오류 `false`: 오류 아님
`sessionLog`	Array	-	세션 로그 (플레이어 동작 사이클 로그)

`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		완료까지 걸린 시간 (초)

응답 상태 코드

Video Player Enhancement API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Video Player Enhancement 응답 상태 코드를 참조해 주십시오.

응답 예시

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

{
	"code": 200,
	"message": "sessionRecent (1d)",
	"result": [
		{
			"logDate": "2025-10-10 09:54:38",
			"no": "14611077",
			"uuid": "ad5aea06-fb78-41c7-b2ad-716b685e32db",
			"origin": "https://mediaplus-demo.web.app",
			"os": "Mac OS / 10.15.7 ↑",
			"device": "PC",
			"totalStartTime": 2.4,
			"rebufferingTime": 0.195,
			"playingTime": 244.624,
			"isError": false,
			"sessionLog": [
				{
					"logDate": "2025-10-10 09:49:46",
					"videoTime": "00:00:00",
					"actionType": "player_start",
					"actionDuration": 5,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:49:46",
					"videoTime": "00:00:00",
					"actionType": "startup",
					"actionDuration": 352,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:50:16",
					"videoTime": "00:00:30",
					"actionType": "playing",
					"actionDuration": 30057,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
                ...
				{
					"logDate": "2025-10-10 09:54:23",
					"videoTime": "00:00:00",
					"actionType": "startup",
					"actionDuration": 239,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:54:38",
					"videoTime": "00:00:15",
					"actionType": "playing",
					"actionDuration": 14978,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				},
				{
					"logDate": "2025-10-10 09:54:38",
					"videoTime": "00:00:15",
					"actionType": "ended",
					"actionDuration": 0,
					"uuid": "ad5aea06-****-****-****-716b685e32db"
				}
			]
		}
	]
}