Control Panel — API documentation

Stream Fetches

Streamfetch object

Stream Fetches represent external streams that are pulled and streamed from your origin.

Descriptions

id Integer Autogenerated

Unique identifier for this object.

Sample value:N/A

cdn_id Integer Autogenerated

The CDN ID that owns this object.

Sample value:8123

stream String Normal Required

Stream Name

May only contain alpha numerical characters, dashes (-), and underscores (_)

Sample value:mystreamname

source_url String Normal Required

URL of the Source stream

RFC 2396 compliant URL

Sample value:rtmp://hostname.com/app/inst/stream

audio_codec String Normal

Audio codec: -1 for none, 0 for copy, or aac

String

Default:0

Sample value:aac

audio_bitrate Integer Normal

Audio bitrate

Range:8000 - 1024000

Sample value:8000

server Integer Normal

Server ID

Integer

Sample value:2

custom_settings Boolean Immutable Required

Custom setttings enabled

Boolean

Default:

Sample value:true

active Boolean Normal Required

Active

Boolean

Default:1

Sample value:true

option:related String

Include related object in results

Default:none

Sample value:streamfetch_servers

type Integer Normal Admin-only

Output type. 1 for RTMP, 2 for HLS

Range:1 - 2

Sample value:1

stream String Normal

Stream Name

Sample value:mystreamname

source_url String Normal

URL of the Source stream

Sample value:rtmp://hostname.com/app/inst/stream

dest_url String Normal Admin-only

URL of the destination stream

Sample value:rtmp://hostname.com/app/inst/stream

video_codec String Normal Admin-only

Video codec: -1 for none, 0 for copy, or aac

Sample value:aac

audio_codec String Normal

Audio codec: -1 for none, 0 for copy, or aac

Sample value:aac

server Integer Normal

Server ID

Sample value:2

custom_settings Boolean Immutable

Custom setttings enabled

Sample value:true

active Boolean Normal

Active

Sample value:true

None

Related endpoints

Streamfetch servers

Lists servers available for streamfetch

Stream

live streams

Examples

Get the Streamfetches object with id .

Example URL

https://api.scaleengine.net/v2/streamfetches/

Example cURL

curl --user 158:8fc8c48da81e6a2a06a9556379bf798af508dc0792497c678b4c3532ba8b637f https://api.scaleengine.net/v2/streamfetches/

Example request body

None

Example response data

{
    "id": "N/A",
    "cdn_id": "8123",
    "stream": "mystreamname",
    "source_url": "rtmp://hostname.com/app/inst/stream",
    "audio_codec": "aac",
    "audio_bitrate": "8000",
    "server": "2",
    "custom_settings": "true",
    "active": "true"
}

Create a new Streamfetches object.

Example URL

https://api.scaleengine.net/v2/streamfetches

Example cURL

curl -X PUT --data-binary @/path/to/request/body --user 158:8fc8c48da81e6a2a06a9556379bf798af508dc0792497c678b4c3532ba8b637f https://api.scaleengine.net/v2/streamfetches

Example request body

{
    "stream": "mystreamname",
    "source_url": "rtmp://hostname.com/app/inst/stream",
    "audio_codec": "aac",
    "audio_bitrate": "8000",
    "server": "2",
    "custom_settings": "true",
    "active": "true"
}

Example response data

{
    "id": "N/A",
    "cdn_id": "8123",
    "stream": "mystreamname",
    "source_url": "rtmp://hostname.com/app/inst/stream",
    "audio_codec": "aac",
    "audio_bitrate": "8000",
    "server": "2",
    "custom_settings": "true",
    "active": "true"
}

Update the Streamfetches object with id .

Example URL

https://api.scaleengine.net/v2/streamfetches/

Example cURL

curl -X POST --data-binary @/path/to/request/body --user 158:8fc8c48da81e6a2a06a9556379bf798af508dc0792497c678b4c3532ba8b637f https://api.scaleengine.net/v2/streamfetches/

Example request body

{
    "stream": "mystreamname",
    "source_url": "rtmp://hostname.com/app/inst/stream",
    "audio_codec": "aac",
    "audio_bitrate": "8000",
    "server": "2",
    "active": "true"
}

Example response data

{
    "id": "N/A",
    "cdn_id": "8123",
    "stream": "mystreamname",
    "source_url": "rtmp://hostname.com/app/inst/stream",
    "audio_codec": "aac",
    "audio_bitrate": "8000",
    "server": "2",
    "custom_settings": "true",
    "active": "true"
}

Delete the Streamfetches object with id .

Example URL

https://api.scaleengine.net/v2/streamfetches/

Example cURL

curl -X DELETE --user 158:8fc8c48da81e6a2a06a9556379bf798af508dc0792497c678b4c3532ba8b637f https://api.scaleengine.net/v2/streamfetches/

Example request body


			
			
Example response data


None


			
				


	








	
Errors





	

			

			
				ACCESS_VIOLATION
			
			
You do not have access to modify this field

		

			

			
				REQUIRED_FIELD
			
			
Missing one or more required fields

		

			

			
				TYPE_MISMATCH
			
			
Data type does not conform to required field type

		

			

			
				MAX_LENGTH_EXCEEDED
			
			
The value exceeded maximum length allowed

		

			

			
				STREAM_INVALID
			
			
May only contain alpha numerical characters, dashes (-), and underscores (_)

		

			

			
				URL_INVALID
			
			
RFC 2396 compliant URL

		

			

			
				INVALID_RANGE
			
			
The value must be between the predefined range