Haivision Media Platform
Haivision Media Platform
Breadcrumbs

Create a Stream

Creates a stream either to the specified IP address and port, or when re-streaming multisource videos, to a destinations list.

Note

For multi-source videos, the address and port are ignored, and a destinations list must be present.

Authorizations: Recordings - STREAM

Requests

Stream 
POST /apis/assets/:assetId/streams
{
  "address": "239.134.32.100",
  "port": 4900
}
Multi-Source Video 
POST /apis/assets/:assetId/streams
{
  "address": "ignored",
  "port": 1,
  "destinations": [{
    "trackId": 3,
    "address": "239.134.32.100",
    "port": 4900
  }, {
    "trackId": 4,
    "address": "239.134.32.100",
    "port": 4901
  }]
}

Response

Success

Stream 
{
  "data": {
    "address": "239.134.32.100",
    "port": 4900,
    "asset": "a907804b-d6d5-4328-9bd6-5aca9abbac8c",
    "username": "haiadmin",
    "id": "5e33bc64-4ff7-47aa-a7d6-562b35a9c4aa"
  }
}
Multi-Source Video 
{
  "data": {
    "address": "239.134.32.100",
    "port": 4900,
    "asset": "a907804b-d6d5-4328-9bd6-5aca9abbac8c",
    "username": "haiadmin",
    "id": "5e33bc64-4ff7-47aa-a7d6-562b35a9c4aa",
    "destinations": [{
      "trackId": 3,
      "address": "239.134.32.100",
      "port": 4900
    }]
  }
}

Note

For multiple destinations, address and port are overwritten respectively to multiple and 0.

Error

Code

Payload

Description

400

{"code":"010005", "name":"MultiSourcesStream",
"message":"Multi-Source recordings must have a
destination list", "httpStatusCode":400}

You must provide a list of destinations for videos that contain multiple sources. You cannot just provide a list of IP addresses.

400

{"code":"010006", "name":"AddressPortAlreadyInUse",
"message":"Address or port already in use",
"httpStatusCode":400}

The system is already streaming to the specified IP address or port.

400

{"code":"010006", "name":"AddressPortAlreadyInUse",
"message":"Address or port already in use by a
source", "httpStatusCode":400}

The system is already configured to use a Source with the specified IP address or port.

400

{"code":"010001", "name":"InputValidation",
"message":<Error message>, "httpStatusCode":400}

Supplied data was insufficient or incorrect.

404

{"code":"040002", "name":"AssetNotFound",
"message":"Video not found", "httpStatusCode":404}

Video with UUID Id not found.