ショートクリップの照会

Prev Next

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

ショートクリップの詳細情報を照会します。

リクエスト

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

メソッド URI
GET /api/v2/channels/{channelId}/shortclip/{id}

リクエストヘッダ

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

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

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

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

リクエスト例

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

curl --location --request GET 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/shortclip/1418' \
--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.snapshotId String - スナップショット ID
content.shortclip Object - ショートクリップ情報
content.shortclip.id Integer - ショートクリップ ID
content.shortclip.status String - ショートクリップの状態
  • CREATING | COMPLETED | PROCESSING_FAIL | UPLOAD_FAIL
    • CREATING: 作成中
    • COMPLETED: 完了
    • PROCESSING_FAIL: 作成失敗
    • UPLOAD_FAIL: アップロード失敗
content.shortclip.createdTime Integer - ショートクリップ作成日時(ミリ秒)
  • Unix Timestamp形式
content.shortclip.updatedTime Integer - ショートクリップ更新日時(ミリ秒)
  • Unix Timestamp形式
content.shortclip.fileSize Integer - ショートクリップファイルサイズ(Byte)
content.shortclip.duration Integer - ショートクリップ再生時間(ミリ秒)
content.shortclip.output Object - 保存情報
content.shortclip.output.accessControl String - ショートクリップファイル保存場所の公開範囲
  • PRIVATE | PUBLIC_READ
    • PRIVATE: 非公開
    • PUBLIC_READ: 公開
content.shortclip.output.bucketName String - ショートクリップファイル保存場所バケット名
content.shortclip.output.filePath String - 保存場所の詳細パス
content.shortclip.output.fileName String - ショートクリップファイル名

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

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

レスポンス例

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

{
    "content": {
        "channelId": "ls-20250814******-zTwK2",
        "snapshotId": 7566,
        "shortclip": {
            "id": 1418,
            "status": "COMPLETED",
            "createdTime": 1755577843872,
            "updatedTime": 1755577844296,
            "fileSize": 810943,
            "duration": 10006,
            "output": {
                "accessControl": "PRIVATE",
                "bucketName": "mybucket",
                "filePath": "/shortclip",
                "fileName": "1418-1755577843872.mp4"
            }
        }
    }
}