Skip to main content

Media Content Key Extension

Notice

This document is a machine-translated draft and is currently undergoing review. Some content may be inaccurate or differ from the original Korean version. For the most precise information, refer to the Korean documentation.

Kollus VOD supports combining a customer-defined Custom ID with an existing media content key. By using this feature, you can control a single physical original file as if it were multiple independent contents within the system.

Caution

The media content key extension feature applies only to standard content(unencrypted). It is not supported for DRM-protected content.

Core principles​

  • Logical separation: For certain personalization features such as downloads and resume playback, the extended key is recognized as a different piece of content.
  • Physical integration: Basic content information is managed commonly based on the original media content key.
  • Example: Similar to Gmail's alias feature. When mail is sent to an extended address, the default address (support@kollus.com) receives it.
    • Default address: support@kollus.com
    • Extended addresses: support-cid1@kollus.com, support-cid2@kollus.com

Request specifications​

When calling standard content(unencrypted), connect the original media content key and the Custom ID with a hyphen (-).

Request URL structure​

https://v.kr.kollus.com/{MEDIA_CONTENT_KEY}-{CUSTOM_ID}

Example​

Since the media content key itself does not contain a hyphen, the Custom ID is distinguished based on the first hyphen.

https://v.kr.kollus.com/vnCVPVyV-custom-id

Constraints​

  • Length limit: Within 64 Bytes
  • Allowed characters: Only alphanumeric characters and hyphens (-) are allowed
  • Encoding note: Multibyte characters such as Korean are not recommended (be careful not to exceed 64 Bytes when UTF-8 encoded)

Features that apply the extended key​

When called via an extended key, the Kollus system creates and manages data separately for each Custom ID for the following items.

  • DRM download callback
  • LMS callback
  • Resume playback
  • Concurrent playback prevention
  • Bookmark