Player Events v2 (Amasian legacy)
Original /api/v2/* routes used by Amasian clients. Behaviour unchanged. Requires s on playlist; drives Continue Watching (Redis) when mci and did or u are present: a signed-in viewer's u (the Amasian user uuid) saves it to the account, otherwise it is saved to the device.
Start a playback session (Amasian legacy)
Collects the playlist event that starts a playback session and returns the stream session id. Behaviour unchanged for Amasian clients; ODK clients use /api/v2/odk/*.
query Parameters
sService name: amasian, odc, ... ODK traffic uses the dedicated /api/v2/odk/* routes.
Service name: amasian, odc, ... ODK traffic uses the dedicated /api/v2/odk/* routes.
dtClient send time, epoch milliseconds.
Client send time, epoch milliseconds.
didClient-generated persistent device id: in an app, stable across app restarts and app updates; on web, a first-party UUID in localStorage with a cookie fallback. Send on every event, and send the same value on player events and telemetry — it is the join key between the two surfaces, so two separately minted UUIDs break the join silently. (Audience counting lives on the telemetry surface, not on player events.)
Client-generated persistent device id: in an app, stable across app restarts and app updates; on web, a first-party UUID in localStorage with a cookie fallback. Send on every event, and send the same value on player events and telemetry — it is the join key between the two surfaces, so two separately minted UUIDs break the join silently. (Audience counting lives on the telemetry surface, not on player events.)
opidOneSignal player id.
OneSignal player id.
pPlatform, e.g. web, ios, android, tvos, roku, tizen, webos, firetv.
Platform, e.g. web, ios, android, tvos, roku, tizen, webos, firetv.
sihotel tv only [techworld_marriott_fullerton]
hotel tv only [techworld_marriott_fullerton]
ststream type [live, on-demand, multiview]
stream type [live, on-demand, multiview]
mcimediahub content id
mediahub content id
chchannel slug
channel slug
slsubtitle language
subtitle language
rAttribution for recommendation engine, Empty if engine is not used. [aws_personal, odk_reco]
Attribution for recommendation engine, Empty if engine is not used. [aws_personal, odk_reco]
attAttribution Source [free-to-watch, continue-watching]
Attribution Source [free-to-watch, continue-watching]
attr_valueAttribution of the playback [watch_full, startover, next_episode, click_next_episode, auto_next_play, continue_watching, search, main_banner, etc]
Attribution of the playback [watch_full, startover, next_episode, click_next_episode, auto_next_play, continue_watching, search, main_banner, etc]
avApp version
App version
cdomain of stream [ol.ondemandkorea.com, hls, kleenex]
domain of stream [ol.ondemandkorea.com, hls, kleenex]
uUser id (spec u, LOGGED-IN only). For Amasian send the signed-in user's uuid (uuid from user/profile/); omit for guests. With s=amasian, a uuid saves Continue Watching for this playback to the account instead of the device. Any other value, or any other s, is stored on the event as sent and leaves Continue Watching on the device.
User id (spec u, LOGGED-IN only). For Amasian send the signed-in user's uuid (uuid from user/profile/); omit for guests. With s=amasian, a uuid saves Continue Watching for this playback to the account instead of the device. Any other value, or any other s, is stored on the event as sent and leaves Continue Watching on the device.
Start a playback session (Amasian legacy) › Responses
Event accepted. Use stream_session_id on the rest of the session.
stream_session_idServer-issued stream session id (ss). Carry it on firstplay and viewhour of the same session.
Watch-time tick (Amasian legacy)
query Parameters
ssstream session id
stream session id
dtClient send time, epoch milliseconds.
Client send time, epoch milliseconds.
vSeconds watched in this tick (default 5; final tick carries the measured value).
Seconds watched in this tick (default 5; final tick carries the measured value).
wpCurrent watching position from the player controller [4186.12]
Current watching position from the player controller [4186.12]
slActive subtitle selected (en,ko ..) (empty if no subtitle selected)
Active subtitle selected (en,ko ..) (empty if no subtitle selected)
Watch-time tick (Amasian legacy) › Responses
Successful Response