MENU
      チャンネルリストの照会

        チャンネルリストの照会


        記事の要約

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

        リクエスト

        GET https://vodstation.apigw.ntruss.com/api/v2/channels
        HTTP

        リクエストパラメータ

        パラメータ名必須の有無タイプ制限事項説明
        pageNoNoIntegerリクエストするページ番号
        総ページ番号は total/pageSizeNo
        pageSizeNoNoIntegerページごとのチャンネル数

        作成したチャンネルをページで分けて照会する

        • <例> 作成したチャンネルが30個であれば、ページごとに10個ずつ表示されるようにチャンネルリストを照会
        GET https://vodstation.apigw.ntruss.com/api/v2/channels?pageNo=1&pageSizeNo=10
        -> 合計30個のチャンネルをページごとに10個単位でリクエストし、最初のページをリクエスト
        
        GET https://vodstation.apigw.ntruss.com/api/v2/channels?pageNo=2&pageSizeNo=10
        -> 合計30個のチャンネルをページごとに10個単位でリクエストし、2番目のページをリクエスト
        
        GET https://vodstation.apigw.ntruss.com/api/v2/channels?pageNo=3&pageSizeNo=10
        -> 合計30個のチャンネルをページごとに10個単位でリクエストし、3番目のページをリクエスト
        Plain text

        リクエストヘッダ

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

        レスポンス

        | フィールド名 | タイプ | 説明 | 備考 |
        |--- |--- |--- |--- |
        | content[] | Array | VOD Station OPEN APIレスポンスオブジェクトの配列 | |
        | content[].id | String | 作成されたチャンネルの ID | |
        | content[].name | Object | チャンネル名 | |
        | content[].channelStatus | Integer | チャンネルの現在の状態 | CREATING、READY、STOPPING、STOPPED、TERMINATING、TERMINATED、FORCE_STOPPING、FORCE_STOPPED、FORCETERMINATING、FORCETERMINATED |
        | content[].storageBucketName | String | チャンネルと連携された Object Storageバケット名 | |
        | content[].encryptedBucketName | String | チャンネルと連携された Object Storageバケットの暗号化された名前で、再生 URL作成時に使用 | |
        | content[].segmentDuration | Integer | チャンネルの segment再生の長さ(単位: 秒) | |
        | content[].segmentDurationOption | String | チャンネルの segment keyframeソートオプション | |
        | content[].accessPrivateFiles | Boolean | バケット内の非公開ファイルに対する VOD Stationからのアクセス制限を設定 | |
        | content[].protocolList[] | Array(String) | チャンネルのストリーミングプロトコルリスト | |
        | content[].createTime | Integer | チャンネルの作成開始時間 | |
        | content[].readyTime | Integer | チャンネルの作成完了時間 | |
        | content[].cdnCreatedTime | Integer | チャンネルと連携して自動作成された CDNの作成時間 | |
        | content[].playUrl | String | CDNを通じた再生 URL Template | |
        | content[].cdnStatus | String | チャンネルと連携された CDNの状態。自動作成しない場合、NOT_FOUNDと表示 | |
        | content[].cdnDomain | String | 自動作成された Global Edgeのドメイン | |
        | content[].cdnServiceName | String | 自動作成された Global Edgeのサービス名 | |
        | content[].cdn | Object | 自動作成された Global Edge情報 | |
        | content[].cdn.cdnType | String | 自動作成された CDNのタイプ | |
        | content[].cdn.cdnDomain | String | 自動作成された Global Edgeのドメイン | |
        | content[].cdn.cdnServiceName | String | 自動作成された Global Edgeのサービス名 | |
        | content[].cdn.profileId | String | 自動作成された Global Edgeのプロファイル ID | |
        | content[].cdn.regionType | String | 自動作成された Global Edgeのサービス地域 | |
        | content[].cdn.cdnInstanceNo | Integer | 自動作成された Global Edgeのインスタンス情報 | |
        | content[].storageBucketStatus | String | チャンネルと連携された Object Storageバケットの状態 | |
        | content[].originPath | String | 作成したチャンネルのソースパスで、別途 CDNを作成する際に参照 | |
        | content[].encryptionList[] | Array | チャンネルのメディアセキュリティ設定 | |
        | content[].encryptionList[].protocol | String | メディアセキュリティ対象のプロトコル | |
        | content[].encryptionList[].mediaEncryptionTypeCode | Integer | メディアセキュリティ設定の暗号化タイプ
        1: AES-128
        2: Sample-AES
        3: CENC | |
        | content[].encryptionList[].drmTypeCode | Intenger | メディアセキュリティ設定の DRMタイプ
        21: FairPlay
        22: Widevine/PlayReady | |
        | content[].encryptionList[].drmTypeName | String | メディアセキュリティ設定の DRMタイプ名 | |
        | content[].encryptionList[].drmContentId | String | VOD Stationでパッケージングする際にリクエストする Content ID | |
        | content[].encryptionList[].systemIdList | Array(String) | VOD Stationでパッケージングする際にリクエストする DRM System ID | |
        | content[].encryptionList[].drmKeyUrl | String | VOD Stationでパッケージングする際にリクエストする DRM CPIX API URL | |
        | content[].drm | Object | VOD Stationを利用した DRM Encryption設定 | |
        | content[].drm.siteId | String | One Click Multi DRMサービスで作成した site id | |
        | content[].drm.contentId | String | DRM Encryption適用対象コンテンツの固有 ID
        DRMパッケージングに使用され、英数字、記号の「-」(ハイフン)、「_」(アンダースコア)のみ使用して3~100文字以内で入力できます。| |
        | total | Integer | チャンネルの総数 | |
        | error | Object | エラーレスポンスコードとメッセージ | |
        | error.errorCode | Integer | エラーレスポンスコード | |
        | error.message | String | エラーレスポンスメッセージ | |
        | error.details | String | error messageの詳細説明
        api gatewayエラー発生時のレスポンス | |

        リクエスト例

        GET https://vodstation.apigw.ntruss.com/api/v2/channels
        
        GET /api/v2/channels
        HOST: vodstation.apigw.ntruss.com
        x-ncp-region_code:KR
        x-ncp-apigw-timestamp:1521787414578
        x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
        x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
        HTTP

        レスポンス例

        HTTP/1.1 200 OK
        Server: nginx
        Date: Wed, 12 Sep 2018 09:53:32 GMT
        Content-Type: application/json;charset=utf-8
        Connection: keep-alive
        Access-Control-Allow-Origin: *
        x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
        
        {
          "content": [
            {
              "id": "vs-20201112113327-Icwk9YO",
              "name": "api-guide-drm",
              "channelStatus": "RUNNING",
              "storageBucketName": "vodstation-bucket",
              "encryptedBucketName": "zz0G2Esbn14HUBlaiZSVkg__",
              "segmentDuration": 5,
              "segmentDurationOption": "BASIC",
              "accessPrivateFiles": true,
              "protocolList": [
                "HLS",
                "DASH"
              ],
              "createTime": 1605148407,
              "cdnCreatedTime": 1605148407,
              "playUrl": "https://example.edge.navercorp.com/[protocol]/[Object Storage Bucket(encryption name)]/[path]/[video filename]/[manifest]",
              "cdnStatus": "RUNNING",
              "cdnDomain": "example.edge.naverncp.com",
              "cdnServiceName": "vscdn-Icwk9YO",
              "storageBucketStatus": "RUNNING",
              "cdn": {
                "cdnType": "GLOBAL_EDGE",
                "cdnDomain": "example.edge.naverncp.com",
                "cdnServiceName": "edge-vs-20230628185044-4HOrw8z",
                "profileId": 681,
                "regionType": "KOREA",
                "cdnInstanceNo": 1000
              },
              "originPath": "vs-k1.video.media.ntruss.com/132/vs-20230628185044-4HOrw8z",
              "drm": {
                "siteId": "ABCD",
                "contentId": "abc-2344-dfd"
              },
              "encryptList": [
                {
                  "protocol": "DASH",
                  "mediaEncryptTypeCode": 3,
                  "mediaEncryptionTypeName": "AES-128",
                  "drmTypeCode": 22,
                  "drmTypeName": "Widevine/PlayReady",
                  "drmContentId": "openapi",
                  "systemIdList": [
                    "9A04F079-9840-4286-AB92-E65BE0885F95",
                    "EDEF8BA9-79D6-4ACE-A3C8-27DCD51D21ED"
                  ],
                  "drmKeyUrl": "https://kms.example.com/cpix/token"
                },
                {
                  "protocol": "HLS",
                  "mediaEncryptTypeCode": 1,
                  "mediaEncryptionTypeName": "AES-128"
                }
              ]
            }
          ],
          "total": 1
        }
        HTTP

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

        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.