チャンネルリストの照会

印刷する
共有
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

Live Stationは、VODチャンネルリストを照会するための APIを提供します。

リクエスト

GET https://livestation.apigw.ntruss.com/api/v2/vod/channels?pageNo={pageNo}&pageSizeNo={pageSizeNo}

リクエストパラメータ

パラメータ名	必須有無	タイプ	制限事項	説明
pageNo	No	Integer	制限なし	照会するページインデックス
pageSizeNo	No	Integer	1 ~ 100	リストの照会時に含まれるチャンネル数例) 作成されたチャンネルが60個の場合、pageSizeNo 30であればページ毎に30個ずつチャンネルリストを照会

リクエストヘッダ

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

レスポンス

フィールド名	タイプ	説明	備考
channelName	String
channelId	String
instanceNo	String
channelStatus	String	CREATING, READY, PUBLISHING, DELETED, BLOCK,RESERVED, FORCE_BLOCK, FORCE_DELETED	VODチャンネルは RESERVED、PUBLISHINGの状態でのみ停止可能
snapshot	Object
snapshotId	Integer
cdn	Object
cdn.cdnType	String	CDN_PLUS, GLOBAL_CDN, GLOBAL_EDGE
cdn.instanceNo	String		NO_CDNの場合は0
cdn.profileId	Integer	Global Edgeのプロファイル ID	NO_CDNの場合は0
cdn.statusName	String	CDNの状態	RUNNING, PUBLISHING, STOPPING, STOPPED, CREATING, CHANGING, CDN_NOT_FOUND
cdn.serviceName	String	CDN Service Name	NO_CDNの場合は""
cdn.cdnDomain	String	CDN Domain	NO_CDNの場合は""
qualitySetId	Integer
qualitySetName	String
outputProtocol	String
alertOn	Boolean
alertOptions	Object
alertOptions.alertChangeStatus	Boolean
totalPublishSeconds	Integer
createdTime	Integer
updatedTime	Integer
envType	String	DEV, STAGE, REAL
type	String	VOD
callbackEndpoint	String
scheduleList	Array		スケジュールが存在する場合のみレスポンス
scheduleList.scheduleId	Integer
scheduleList.status	String
drmEnabledYn	Boolean	DRM Encryption設定の適用有無
drm	Object	Live Stationを活用した DRM Encryption設定 DRM設定時、FairPlay、Widevine/PlayReady DRMサポート
drm.siteId	String	One Click Multi DRMサービスで作成した site id
drm.contentId	String	DRM Encryptionを適用するコンテンツの固有 ID DRMパッケージのために使用し、最低3文字以上の英数字または「-」(ハイフン)、「_」(アンダースコア)を含む最大100文字まで入力可能です。

例

リクエスト例

GET /api/v2/vod/channels
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 Feb 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-20211122214005-DMOTD",
      "channelName": "myChannel1",
      "instanceNo": 2042924,
      "qualitySetId": 4,
      "qualitySetName": "720p-set",
      "outputProtocol": "HLS",
      "status": "READY",
      "cdn": {
        "instanceNo": "1541959",
        "serviceName": "cdn-ls-20201204112949-D7RTL",
        "statusName": "running",
        "cdnType": "CDN_PLUS",
        "cdnDomain": "mycdn.cdn.ntruss.com",
        
      },
      "totalPublishSeconds": 5405,
      "createdTime": 1637584805000,
      "updatedTime": 1637591709000,
      "alertOn": false,
      "recentPublishTime": 1637586303000,
      "alertOptions": {
        "alertChangeStatus": false
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "REAL",
      "type": "VOD",
      "drmEnabledYn": true,
      "drm": {
        "siteId": "drm-20231115142326-nHyNw",
        "contentId": "my-Test-Multidrm"
      },
      "scheduleList": [
        {
          "scheduleId": 10049,
          "status": "FINISH"
        }
      ]
    },
    {
      "channelId": "ls-20211117184137-8rRjJ",
      "channelName": "myChannel2",
      "instanceNo": 2029554,
      "qualitySetId": 4,
      "qualitySetName": "720p-set",
      "outputProtocol": "HLS",
      "status": "READY",
      "cdn": {
        "instanceNo": "1541959",
        "serviceName": "cdn-ls-20201204112949-D7RTL",
        "statusName": "running",
        "cdnType": "CDN_PLUS",
        "cdnDomain": "mycdn.cdn.ntruss.com",
        
      },
      "totalPublishSeconds": 21604,
      "createdTime": 1637142098000,
      "updatedTime": 1637309411000,
      "alertOn": false,
      "recentPublishTime": 1637287806000,
      "alertOptions": {
        "alertChangeStatus": false
      },
      "callbackEndpoint": "https://my-callback-endpoint",
      "envType": "DEV",
      "type": "VOD",
      "drmEnabledYn": true,
      "drm": {
        "siteId": "drm-20231115142326-nHyNw",
        "contentId": "my-Test-Multidrm"
      },
      "scheduleList": [
        {
          "scheduleId": 10019,
          "status": "FINISH"
        }
      ],
      "audioOnly": false
    }
  ],
  "total": 2
}

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

What's Next

チャンネル情報の照会

リクエスト
レスポンス
例

タグ

Live Station