Classic/VPC環境で利用できます。
一般のライブチャンネルで発生したイベントリストを照会します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| GET | /api/v2/channels/{channelId}/events |
リクエストヘッダ
Live Station APIで共通して使用されるヘッダの詳細は、Live Stationのリクエストヘッダをご参照ください。
リクエストパスパラメータ
リクエストパスパラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
channelId |
String | Required | チャンネル ID
|
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250818******-KRXat/events' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json'
レスポンス
レスポンス形式を説明します。
レスポンスボディ
レスポンスボディの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
content |
Array | - | イベントリスト: content |
total |
Integer | - | レスポンス総数 |
content
contentの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
logLevel |
String | - | ログレベル
|
eventCode |
String | - | イベントコード |
description |
String | - | イベントの説明 |
timestamp |
Integer | - | イベント発生日時(ミリ秒)
|
channelId |
String | - | チャンネル ID |
レスポンスステータスコード
Live Station APIで共通して使用されるレスポンスステータスコードの詳細は、Live Stationのレスポンスステータスコードをご参照ください。
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"content": [
{
"logLevel": "INFO",
"eventCode": "PUBLISH_END",
"description": "channel000 channel publishing has ended.",
"timestamp": 1755591429630,
"channelId": "ls-20250818******-KRXat"
},
{
"logLevel": "INFO",
"eventCode": "ONAIR_END",
"description": "channel000 Channel recording has ended.",
"timestamp": 1755591396176,
"channelId": "ls-20250818******-KRXat"
},
{
"logLevel": "INFO",
"eventCode": "ONAIR_START",
"description": "You have started recording channel channel000.",
"timestamp": 1755591356004,
"channelId": "ls-20250818******-KRXat"
},
{
"logLevel": "INFO",
"eventCode": "PUBLISH_START",
"description": "You have started publishing channel channel000.",
"timestamp": 1755591346586,
"channelId": "ls-20250818******-KRXat"
},
...
],
"total": 25
}