ライブカーテンの終了

Prev Next

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

配信中ライブカーテンを強制終了します。

リクエスト

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

メソッド URI
POST /api/v2/channels/{channelId}/curtain/remove

リクエストヘッダ

Live Station APIで共通して使用されるヘッダの詳細は、Live Stationのリクエストヘッダをご参照ください。

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

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

フィールド タイプ 必須の有無 説明
channelId String Required チャンネル ID

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/curtain/remove' \
--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 Object - レスポンス結果
content.content Object - ライブカーテン情報
content.content.ids Array - コンテンツ IDリスト
content.content.insertTime Integer - ライブカーテンの維持時間(分)
content.content.responseTime Integer - レスポンスタイム(ミリ秒)
  • Unix Timestamp形式
content.channelId String - チャンネル ID
content.isLiveCurtain Boolean - ライブカーテンは進行中か
  • true | false
    • true: 進行中
    • false: 進行中ではない

レスポンスステータスコード

Live Station APIで共通して使用されるレスポンスステータスコードの詳細は、Live Stationのレスポンスステータスコードをご参照ください。

レスポンス例

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

{
    "content": {
        "content": {
            "ids": [
                414
            ],
            "insertTime": 10,
            "responseTime": 1755586043299
        },
        "channelId": "ls-20250814******-zTwK2",
        "isLiveCurtain": false
    }
}