Get channel list
    • PDF

    Get channel list

    • PDF

    Article summary

    VOD Station provides an API to search channel lists.

    Request

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

    Request parameters

    Parameter nameRequiredTypeRestrictionsDescription
    pageNoNoIntegerPage number to request
    For total page numbers, total/pageSizeNo
    pageSizeNoNoIntegerNumber of channels per page

    Get created channels by page

    • <Example> Searching the channel list to view 10 channels per page when 30 channels have been created
    GET https://vodstation.apigw.ntruss.com/api/v2/channels?pageNo=1&pageSizeNo=10
    -> Request the first page from a total of 30 channels, separated by 10 per page
    
    GET https://vodstation.apigw.ntruss.com/api/v2/channels?pageNo=2&pageSizeNo=10
    -> Request the second page from a total of 30 channels, separated by 10 per page
    
    GET https://vodstation.apigw.ntruss.com/api/v2/channels?pageNo=3&pageSizeNo=10
    -> Request the third page from a total of 30 channels, separated by 10 per page
    

    Request headers

    Header nameDescription
    x-ncp-region_codeNAVER Cloud Platform Region code
    x-ncp_region_code:{Region Code}
    x-ncp-apigw-timestampIt indicates the elapsed time in milliseconds since January 1, 1970 00:00:00 UTC. Request is considered invalid if the timestamp differs from the current time by more than 5 minutes
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-iam-access-keyAccess key ID value issued on NAVER Cloud Platform portal
    x-ncp-iam-access-key:{Sub Account Access Key}
    x-ncp-apigw-signature-v2Signature encrypted with the access key ID value and secret key
    x-ncp-apigw-signature-v2:{API Gateway Signature}

    Response

    | Field name | Type | Description | Remarks |
    |--- |--- |--- |--- |
    | content[] | Array | VOD Station open API response object array | |
    | content[].id | String | ID of the created channel | |
    | content[].name | Object | Channel name | |
    | content[].channelStatus | Integer | Channel's current status | CREATING, READY, STOPPING, STOPPED, TERMINATING, TERMINATED, FORCE_STOPPING, FORCE_STOPPED, FORCETERMINATING, FORCETERMINATED |
    | content[].storageBucketName | String | Name of the Object Storage bucket integrated with the channel | |
    | content[].encryptedBucketName | String | Encrypted name of the Object Storage bucket integrated with the channel, used when creating the playback URL | |
    | content[].segmentDuration | Integer | Segment duration of the channel (unit: second) | |
    | content[].segmentDurationOption | String | Channel's segment keyframe sorting options | |
    | content[].accessPrivateFiles | Boolean | Set access restrictions in VOD Station for private files in the bucket | |
    | content[].protocolList[] | Array(String) | List of streaming protocols of the channel | |
    | content[].createTime | Integer | The time channel creation started | |
    | content[].readyTime | Integer | The time channel creation was completed | |
    | content[].cdnCreatedTime | Integer | The time when the CDN was automatically created in integration with the channel | |
    | content[].playUrl | String | CDN-based playback URL template | |
    | content[].cdnStatus | String | Status of the CDN integrated with the channel. Displayed as NOT_FOUND if the CDN was not automatically created | |
    | content[].cdnDomain | String | Auto-generated Global Edge's domain | |
    | content[].cdnServiceName | String | Auto-generated Global Edge's service name | |
    | content[].cdn | Object | Auto-generated Global Edge information | |
    | content[].cdn.cdnType | String | Auto-generated CDN type | |
    | content[].cdn.cdnDomain | String | Auto-generated Global Edge's domain | |
    | content[].cdn.cdnServiceName | String | Auto-generated Global Edge's service name | |
    | content[].cdn.profileId | String | Auto-generated Global Edge's profile ID | |
    | content[].cdn.regionType | String | Auto-generated Global Edge's service area | |
    | content[].cdn.cdnInstanceNo | Integer | Auto-generated Global Edge's instance information | |
    | content[].storageBucketStatus | String | Status of the Object Storage bucket integrated with the channel | |
    | content[].originPath | String | Source path of the created channel, which is referred to when an independent CDN is created | |
    | content[].encryptionList[] | Array | Media security settings of the channel | |
    | content[].encryptionList[].protocol | String | Media security target protocol | |
    | content[].encryptionList[].mediaEncryptionTypeCode | Integer | Media security setting's encryption type
    1: AES-128
    2: Sample-AES
    3: CENC | |
    | content[].encryptionList[].drmTypeCode | Intenger | Media security setting's DRM type
    21: FairPlay
    22: Widevine/PlayReady | |
    | content[].encryptionList[].drmTypeName | String | Name of the media security setting's DRM type | |
    | content[].encryptionList[].drmContentId | String | Content ID to be requested when packaging from VOD Station | |
    | content[].encryptionList[].systemIdList | Array(String) | DRM system ID to be requested when packaging from VOD Station | |
    | content[].encryptionList[].drmKeyUrl | String | DRM CPIX API URL to be requested when packaging from VOD Station | |
    | content[].drm | Object | DRM encryption settings using VOD Station | |
    | content[].drm.siteId | String | Site id created with One Click Multi DRM product | |
    | content[].drm.contentId | String | Unique ID of the content to apply DRM encryption to
    It is used for DRM packaging and can be at least 3 characters and up to 100 characters, including English letter, numbers, "-" (hyphen), and "_" (underscore) | |
    | total | Integer | Total number of channels | |
    | error | Object | Error response code and message | |
    | error.errorCode | Integer | Error response code | |
    | error.message | String | Error response message | |
    | error.details | String | Detailed description of the error message
    It responds when an error occurs in the API Gateway | |

    Examples

    Request example

    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=
    

    Response example

    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
    }
    

    Was this article helpful?

    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.