Xonaplay API

Generate an API key from the dashboard (Workspace → API Keys). Production keys are prefixed with xpl_live_. Send it as a Bearer token and confirm the connection by listing your videos.

curl https://api.xonaplay.com/v1/videos \
  -H "Authorization: Bearer xpl_live_8f3c2a9b41d7e6..." \
  -H "X-Xona-Workspace: ws_4a7f21c9"

Ask the control plane for an upload ticket. It returns an engine uploadUrl and a short, single-use token (X-Upload-Token). You upload the raw file directly to the engine with that token, bypassing the control plane.

# 1) Request the ticket
curl -X POST https://api.xonaplay.com/v1/videos/upload-ticket \
  -H "Authorization: Bearer xpl_live_8f3c2a9b41d7e6..." \
  -H "X-Xona-Workspace: ws_4a7f21c9" \
  -H "Content-Type: application/json" \
  -d '{"filename":"demo.mp4","title":"My demo"}'
# => { "videoId":"vid_92ab", "uploadUrl":"https://engine.xonaplay.com/upload", "uploadToken":"ut_3f..." }

# 2) Upload the file straight to the engine
curl -X POST https://engine.xonaplay.com/upload \
  -H "X-Upload-Token: ut_3f..." \
  -F "[email protected]"

Poll the video (or subscribe to a webhook) until status is ready. Once transcoding finishes, the response includes the master.m3u8 URL with the adaptive variants, ready for your player.

curl https://api.xonaplay.com/v1/videos/vid_92ab \
  -H "Authorization: Bearer xpl_live_8f3c2a9b41d7e6..." \
  -H "X-Xona-Workspace: ws_4a7f21c9"
# => { "id":"vid_92ab", "status":"ready",
#      "hls":"https://api.xonaplay.com/v1/hls/ws_4a7f21c9/vid_92ab/master.m3u8",
#      "variants":["360p","480p","720p","1080p"] }