Session management

​

What You’ll Need

• A BMDRM account (Log in or sign up for a free trial).
• Have your API key prepared. To learn how to obtain your Streaming API key, see Obtaining your API key.
• The requested video to be uploaded and ready.

​

How to create streaming sessions

POST https://cdn-lb.video-crypt.com/api/v2.0/sessions?videoId={video ID}&userId={user ID}

• apiKey: Your Streaming API key.
• accept: Must be application/json.

• videoId: The ID of the video to play. This is the uploadJobId returned during the upload initialization step.
• userId : The user’s identifier in your system. This value is rendered into the session’s visible watermark.

curl --request POST \
  --url 'https://cdn-lb.video-crypt.com/api/v2.0/sessions?videoId=00f05208-a732-4b7a-a616-74d2fb51445b&userId=demo_user' \
  --header 'apiKey: <Your Streaming API key>' \
  --header 'Accept: application/json'

• edge: A CDN edge url, responsible for serving the created session (string)
• videoId: The ID of the requested video (uuid)
• signature: A session signature to be verified by BMDRM (string)
• userId: The user ID supplied by the client (string)
• subscriptionId: The corresponding ID of the client subscription (uuid)
• sessionId: The ID of the one-time use session (uuid)
• nonce: One-time use number (string)
• date: Timestamp of session creation (number)

​

Session lifetime

• Each session is valid for a single playback. Requesting playback again with the same sessionId and nonce will fail.

​

Web-only streaming sessions

POST https://cdn-lb.video-crypt.com/api/sessions?videoId={video ID}&userId={user ID}

curl --request POST \
  --url 'https://cdn-lb.video-crypt.com/api/sessions?videoId=00f05208-a732-4b7a-a616-74d2fb51445b&userId=demo_user' \
  --header 'apiKey: <Your Streaming API key>' \
  --header 'Accept: application/json'