チャンネル情報の照会
    • PDF

    チャンネル情報の照会

    • PDF

    記事の要約

    Live Stationはチャンネルの詳細情報照会用の APIを提供します。

    リクエスト

    GET https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}
    

    リクエストヘッダ

    ヘッダ名必須の有無説明
    x-ncp-apigw-timestampYES1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表し、API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-iam-access-keyYESNAVERクラウドプラットフォームポータルから発行された Access Key ID
    x-ncp-iam-access-key:{Sub Account Access Key}
    x-ncp-apigw-signature-v2YESAccess Key IDと Secret Keyで暗号化した署名
    x-ncp-apigw-signature-v2:{API Gateway Signature}
    x-ncp-region_codeYESリージョンコード (KR)

    レスポンス

    フィールド名タイプ説明備考
    channelIdString
    channelNameString
    instanceNoString
    qualitySetIdInteger
    qualitySetNameString
    outputProtocolString
    channelStatusStringCREATING、READY、PUBLISH、DELETED、BLOCK、FORCE_BLOCK、FORCE_DELETED
    isRecordingBoolean
    useDvrBoolean
    immediateOnAirBooleantrue、false
    timemachineMinInteger単位: Minute
    uploadPathStringAUTO_UPLOADオプションの場合の録画ファイルのアップロードパス
    snapshotObject
    snapshotIdInteger
    recordObject
    record.formatStringMP4、HLS、ALL
    record.typeStringNO_RECORD、AUTO_UPLOAD、MANUAL_UPLOAD
    record.bucketNameString
    record.filePathString
    record.accessControlStringPRIVATE、PUBLIC_READ
    cdnObject
    cdn.cdnTypeStringGLOBAL_CDN、GLOBAL_EDGE
    cdn.instanceNoStringNO_CDNの場合は0
    cdn.profileIdIntegerGlobal Edgeのプロファイル IDNO_CDNの場合は0
    cdn.statusNameStringCDNの状態RUNNING、PUBLISHING、STOPPING、STOPPED、CREATING、CHANGING、CDN_NOT_FOUND
    cdn.serviceNameStringCDN Service NameNO_CDNの場合は""
    cdn.cdnDomainStringCDN DomainNO_CDNの場合は""
    publishUrlString
    globalPublishUrlString海外配信サポートのための URL
    streamKeyString
    recentPublishStartTimeInteger
    createdTimeInteger
    alertOnBoolean
    alertOptionsObject
    alertOptions.alertChangeStatusBoolean
    alertOptions.alertVodUploadFailBoolean
    alertOptions.alertReStreamFailBoolean
    totalPublishSecondsInteger
    envTypeStringDEV、STAGE、REAL
    callbackEndpointString
    backupStreamKeyString配信冗長化のためのバックアップストリームキー
    isStreamFailOverBoolean配信冗長化設定の適用有無true、false
    originObjectCDN連携のための Live Stationソース情報
    origin.originDomainStringCDN連携のための Live Stationソースドメイン
    origin.originPathStringCDN連携のための Live Stationソースの詳細パス
    drmEnabledYnBooleanDRM Encryption設定の適用有無
    drmObjectLive Stationを利用した DRM Encryption設定
    drm.siteIdStringOne Click Multi DRMサービスで作成した site id
    drm.contentIdStringDRM Encryption適用対象コンテンツの固有 ID
    DRMパッケージングに使用され、英数字、記号の「-」(ハイフン)、「_」(アンダースコア)のみ使用して3~100文字以内で入力できます。

    リクエスト例

    GET /api/v2/channels/ls-20200323114720-bMoDF
    HOST: livestation.apigw.ntruss.com
    Content-Type: application/json
    x-ncp-apigw-timestamp:1521787414578
    x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
    x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
    x-ncp-region_code:KR
    

    レスポンス例

    HTTP/1.1 200 OK
    Server: nginx
    Date: Fri, 26 Sep 2021 09:53:32 GMT
    Content-Type: application/json;charset=utf-8
    Connection: keep-alive
    Access-Control-Allow-Origin: *
    x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
    
    {
      "content": {
        "channelId": "ls-20200323114720-bMoDF",
        "channelName": "mychannel",
        "instanceNo": 1163899,
        "qualitySetId": 6,
        "qualitySetName": "360p-set",
        "outputProtocol": "HLS, DASH",
        "channelStatus": "READY",
        "isRecording": false,
        "useDVR": true,
        "immediateOnAir": false,
        "timemachineMin": 360,
        "cdn": {
          "instanceNo": "1163900",
          "serviceName": "edge-ls-20230914204831-1BRHO",
          "statusName": "RUNNING",
          "cdnType": "GLOBAL_EDGE",
          "cdnDomain": "mycdn.edge.naverncp.com",
          "profileId": 299,
          "regionType": "KOREA"
        },
        "record": {
          "type": "AUTO_UPLOAD",
          "bucketName": "hls",
          "filePath": "/livestation",
          "format": "MP4",
          "accessControl": "PRIVATE"
        },
        "drm": {
          "contentId": "my-first-drm",
          "siteId": "drm-20231120182420-dPTGn"
        },
        "drmEnabledYn": true,
        "uploadPath": "/hls/livestation",
        "publishUrl": "rtmp://live-station-rtmp-url",
        "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
        "streamKey": "jjiantco4psakuwd5526u2glcxrqaar4",
        "totalPublishSeconds": 0,
        "createdTime": 1584931640000,
        "recentPublishStartTime": 0,
        "alertOn": false,
        "alertOptions": {
          "alertChangeStatus": false,
          "alertVodUploadFail": false,
          "alertReStreamFail": false
        },
        "callbackEndpoint": "https://my-callback-endpoint",
        "envType": "REAL",
        "origin": {
          "originDomain": "ls-k1.video.media.ntruss.com",
          "originPath": "1"
        },
        "backupStreamKey": "lbuy4dcrxk2ctxs8uqxanpy833p08vvz?backup=true",
        "isStreamFailOver": true
      }
    }
    

    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.