Classic/VPC環境で利用できます。
同時配信(Re-Stream)チャンネルで発生した配信イベントリストを照会します。
リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | URI |
|---|---|
| GET | /api/v2/re-stream/channels/{channelId}/publish-log |
リクエストヘッダ
Live Station APIで共通して使用されるヘッダの詳細は、Live Stationのリクエストヘッダをご参照ください。
リクエストパスパラメータ
リクエストパスパラメータの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|---|---|---|---|
channelId |
String | Required | チャンネル ID
|
リクエスト例
リクエストのサンプルコードは次の通りです。
curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/re-stream/channels/ls-20250819******-Ik1QU/publish-log' \
--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": "channel001 channel publishing has ended.",
"timestamp": 1755757448902,
"channelId": "ls-20250819******-Ik1QU"
},
{
"logLevel": "INFO",
"eventCode": "PUBLISH_START",
"description": "You have started publishing channel channel001.",
"timestamp": 1755757279873,
"channelId": "ls-20250819******-Ik1QU"
},
{
"logLevel": "INFO",
"eventCode": "PUBLISH_END",
"description": "channel001 channel publishing has ended.",
"timestamp": 1755757163744,
"channelId": "ls-20250819******-Ik1QU"
},
{
"logLevel": "INFO",
"eventCode": "PUBLISH_START",
"description": "You have started publishing channel channel001.",
"timestamp": 1755757143742,
"channelId": "ls-20250819******-Ik1QU"
}
],
"total": 4
}