Haivision Media Platform
Haivision Media Platform
Breadcrumbs

Create a Source

This method creates a source. 

Authorizations: Sources - CREATE

Requests

UDP Request 
POST /apis/sources
{ 
  "description": "",
  "host": "239.35.126.101",
  "multicast": true,
  "name": "InfoDevSource",
  "port": 4902,
  "type": "UDP"
}
SRT Listener Request 
POST /apis/sources
{
  "description": "SRT listener source",
  "host": "0.0.0.0",
  "mode": "LISTENER",
  "name": "SRTsource",
  "port": 1234,
  "type": "SRT"
}

Response

Success

UDP Response 
{
 "data": {
  "description": "",
  "ctime": 1715705190,
  "mtime": 1715705190,
  "host": "239.35.126.101",
  "port": 4902,
  "type": "UDP",
  "multicast": true,
  "continuous": false,
  "iptv": false,
  "retransmitPort": 0,
  "rtcPort": 0,
  "detectedFeatures": {
   "autodetectEnabled": true,
   "hevc": false, 
   "_4k": false
  },
  "active": false,
  "bitrate": 0,
  "id": "2762c3ec-062b-4374-a86c-3b365313071d",
  "name": "InfoDevSource"
 }
}
SRT Listener Response 
{
 "data": {
  "description": "SRT listener source",
  "ctime": 1715707443,
  "mtime": 1715707443,
  "host": "0.0.0.0",
  "port": 1234,
  "type": "SRT",
  "continuous": true,
  "mode": "LISTENER",
  "latency": 20,
  "iptv": false,
  "retransmitPort": 0,
  "rtcPort": 0,
  "detectedFeatures": {
    "autodetectEnabled": true,
    "hevc": false,
    "_4k": false
  },
  "active": false,
  "bitrate": 0,
  "id": "8082fd89-7b5a-45b5-9c0c-1d60b1e14252",
  "name": "SRTsource"
  }
}

Error

Code

Payload

 Description

400

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

No sources available.

404

{"code":"040009", "name":"SourceNotFound",
"message":"Source not found", "httpStatusCode":404}

Source with UUID sourceId not found.

500

{"code": "070014", "name":"FileWrite",
"message": "Error writing to file", "httpStatusCode": 500}

Unable to write new data to a file.