StreamCreate()

This API is used to create Stream leases for LASP nodes. These leases are used to validate requests to stream Ultraviolet content.

An Ultraviolet Account is permitted a maximum of 12 concurrent, active Sreams. Streams automatically expire after 6 hours and can be renewed for a maximum of 24 hours using the StreamRenew() API.

API URL:

[BaseURL]/Account/{AccountID}/Stream

Request Method:

POST

Request Parameters:

• AccountID is the unique identifier for an account

Request Format

XML type:

• dece:Stream

Required information:

• Stream
  • RequestingUserID
  • RightsTokenID

Optional information:

• Stream/StreamClientNickname

  Optional nickname for the stream client

Headers:

• Authorization: SAML2 assertion=[Assertion]

Response Format

Status Code:

• HTTP 201

Headers:

• Location: [BaseURL]/Account/{AccountID}/Stream/{StreamHandleID}

Errors

• AccountStreamCountExceedMaxLimit
  • The maximum number of streams allowed in an account has been reached
  • HTTP Status Code: 409

Example

Create a new Stream

The following example will create a new Stream lease for a given Account and RightsTokenID.

Sample Request:

POST /rest/2015/02/Account/urn:dece:accountid:org:dece:16EBFA93BAC64DBD875336ED4B6D3CC9/Stream HTTP/1.1
Host: api.uvvu.com
Accept: application/xml
Authorization: SAML2 assertion=[Assertion]

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Stream xmlns="http://www.decellc.org/schema/2015/03/coordinator">
  <RequestingUserID>urn:dece:userid:org:dece:16EBFA93BAC64DBD875336ED4B6D3CC9</RequestingUserID>
  <RightsTokenID>urn:dece:rightstokenid:org:dece:22F5178A987D4710AFFB8EA28895A174</RightsTokenID>
</Stream>

Sample Response:

HTTP/1.1 200
Date: [Date]
Location: https://api.uvvu.com/rest/2015/02/Account/urn:dece:accountid:org:dece:16EBFA93BAC64DBD875336ED4B6D3CC9/Stream/urn:dece:streamhandleid:org:dece:22F5178A987D4710AFFB8EA28895A174
X-transaction-info: [TransactionInfo]

See Also

• StreamDelete()
• StreamRenew()
• StreamView()
• StreamList()