スナップショットの照会

Prev Next

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

スナップショット情報を照会します。作成後1時間以内のスナップショットを照会できます。

リクエスト

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

メソッド URI
GET /api/v2/channels/{channelId}/snapshot/{snapshotId}

リクエストヘッダ

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

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

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

フィールド タイプ 必須の有無 説明
channelId String Required チャンネル ID
snapshotId String Required スナップショット ID

リクエスト例

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

curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/snapshot/7526' \
--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.channelId String - チャンネル ID
content.channelStatus String - チャンネルの状態
  • CREATING | READY | PUBLISHING | DELETED | BLOCK | FORCE_BLOCK | FORCE_DELETED
    • CREATING: 作成中
    • READY: 準備完了
    • PUBLISHING: 配信中
    • DELETED: 削除完了
    • BLOCK: 停止
    • FORCE_BLOCK: 強制停止
    • FORCE_DELETED: 使用不可
content.snapshot Object - スナップショット情報
content.snapshot.snapshotId Integer - スナップショット ID
  • 今後スナップショット情報照会時に必要
content.snapshot.snapshotUrl String - スナップショット再生 URL
  • 作成時点から1時間有効
content.snapshot.createdTime Integer - スナップショット作成日時(ミリ秒)
  • Unix Timestamp形式
content.snapshot.expireTime Integer - スナップショット期限日時(ミリ秒)
  • Unix Timestamp形式
content.snapshot.duration Integer - スナップショットリクエスト時間(分)

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

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

レスポンス例

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

{
    "content": {
        "channelId": "ls-20250814******-zTwK2",
        "channelStatus": "PUBLISHING",
        "snapshot": {
            "snapshotId": 7526,
            "snapshotUrl": "https://*************.edge.naverncp.com/dvr/snapshot/1755508932161/als-nmssenc02/l6f07uzuaex2hriziguozw291avx4xqfrf6k/480p-16-9/7526-1755505332161.m3u8",
            "createdTime": 1755505332161,
            "expireTime": 1755508932161,
            "duration": 8
        }
    }
}