---
title: "セッションの直近リストの照会"
slug: "vpe-api-sessionrecent"
updated: 2026-09-17T09:58:18Z
published: 2026-09-17T09:58:18Z
canonical: "api.ncloud-docs.com/vpe-api-sessionrecent"
---

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

# セッションの直近リストの照会

Classic/VPC環境で利用できます。

プレイヤーを使用したユーザーの直近100セッションを照会します。照会開始点と終了点の間隔に応じてデータ間隔が異なります。

| 開始点と終了点の間隔 | インターバル |
| --- | --- |
| 1日以下 | 5分単位 |
| 2日以上 | 1日単位 |

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| GET | /v1/sessionRecent |

### リクエストヘッダ

Video Player Enhancement APIで共通して使用されるヘッダの詳細は、[Video Player Enhancementのリクエストヘッダ](/docs/ja/vpe-api-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

### リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `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](/docs/ja/vpe-api-sessionrecent#result) |

#### `result`

`result`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `no` | Integer | - | 番号 |
| `logDate` | Date | - | セッションの作成日時 |
| `uuid` | String | - | ユニークユーザー番号 - UUID形式 |
| `origin` | String | - | 呼び出しドメイン |
| `os` | String | - | OS情報 |
| `device` | String | - | プレイヤー再生環境 - `PC,Mobile` \| `PC` \| `Mobile` |
| `totalStartTime` | Integer | - | 再生完了報告までかかった時間 (秒) |
| `rebufferingTime` | Integer | - | バッファリング時間(秒) |
| `playingTime` | Integer | - | 再生時間 (秒) |
| `isError` | Boolean | - | エラーかどうか - `true` \| `false` - `true`: エラー - `false`: エラーではない |
| `sessionLog` | Array | - | セッションログ (プレイヤー動作サイクルログ): [sessionLog](/docs/ja/vpe-api-sessionrecent#sessionLog) |

#### `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のレスポンスステータスコード](/docs/ja/vpe-api-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

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