media_subtitles_get

Read VOD subtitle tracks and, optionally, validate a staged file for creating a track in OTT (C00002), serial (C00006) or courses (C00007).

Inputs and result

Provide channelCode, exact pAppCode, positive integer postId and optional assetId (8–160 letters, digits, underscores or hyphens). Include the trusted staged asset when preparing creation; omit it for deletion. The adapter resolves vid from the selected VOD post. Post, VOD and subtitle IDs are distinct.

MEDIA_SUBTITLES returns post identity, isSampleData, subtitles, available languages, remainingSlots, optional asset metadata, revision, playbackVerified:false and writesPerformed:false. Track fields include id, name, language, isDefault, createdAt and state (PROGRESS, DONE, ERROR, UNKNOWN). It does not expose cue text, subtitle file URLs or playback credentials. Sample posts skip the subtitle-list fetch and cannot be changed by this workflow.

Use revision with media_subtitle_apply for the same post and asset choice. Creation revisions include the staged file and storage snapshot; deletion revisions are read without an asset. Returned languages are the unused choices from the 63 source language keys, including their exact region/numeric variants. Do not synthesize language names.

Input example

Illustrative input only. Replace the channel, installed app, identifiers and revision with values obtained for the selected target.

{
  "channelCode": "selected-channel",
  "pAppCode": "C00002",
  "postId": 1,
  "assetId": "example-asset-001"
}