Playback & access

Every lesson in WireVoD is private. Nothing plays until your backend creates a playback session: personal, time-limited access to one asset for one viewer.

Create a session

Create the session when a learner opens a lesson, after your own checks (enrolment, subscription, payment).

/v1/playback/sessions (scope read)

Request body

{ "asset_id": "6f1c2a9e-…", "ttl_seconds": 3600 }

ttl_seconds is optional: 60 seconds to 24 hours, default 4 hours. The asset must be ready.

Response · 201

{
  "session": {
    "id": "3d9a51c4-…",
    "asset_id": "6f1c2a9e-…",
    "expires_at": 1760284800000,
    "drm": false
  },
  "token": "v1.eyJ…",
  "urls": {
    "manifest": "https://media.wirevod.online/v1/play/v1.eyJ…/package/hls/master.m3u8",
    "telemetry": "https://media.wirevod.online/v1/telemetry"
  }
}

Return this response to the learner’s browser and pass it to WirePlayer. For protected assets the response also includes urls.entitlement, used automatically by WirePlayer (see Content protection).

Tip

Create sessions just in time and keep ttl_seconds close to the expected viewing time. A shorter lifetime makes a shared link worth less.

End a session

/v1/playback/sessions/{id} (scope read) ends access. Within about two minutes the session stops working everywhere, including for protected lessons. Use it when a subscription ends, a learner leaves a course or a link is shared.

Delivery details

• urls.manifest is a standard HLS stream URL. WirePlayer and any modern HLS player can use it.
• All URLs are scoped to the session and stop working when it expires or is ended.
• Responses allow cross-origin requests, so you can play lessons on your own domain.
• Each asset has three preview images at …/v1/play/<token>/thumbs/thumb_0001.jpg, thumb_0002.jpg and thumb_0003.jpg.

Status	code	Meaning
403	playback_expired	The session has expired; create a new one
403	playback_revoked	The session was ended
403	playback_bad_signature, playback_malformed, playback_unknown_key	The URL was modified or isn’t a valid session
404	not_found	No such file for this lesson

Playback insights

WirePlayer reports how each session plays (start-up time, interruptions, quality changes, errors and completion) to urls.telemetry. Reports carry the session reference and the viewer’s browser and country; nothing from your page is collected.