Skip to main content

Broadcast

info

Eyeson supports broadcasting to a single RTMP destination. For multicasting to multiple platforms simultaneously, please utilize a third-party restream service that can distribute your stream to multiple destinations.

Start broadcast​

To connect an Eyeson room with a broadcast (like facebook, YouTube, LinkedIn and similar) you have to provide a valid streaming RTMP url.

POST /rooms/`ACCESS_KEY`/broadcasts
RESPONSES 201 CREATED, 400 BAD REQUEST, 404 NOT FOUND, 405 METHOD NOT ALLOWED, 406 NOT ACCEPTABLE, 410 GONE
REQUIRED stream_url
Req/Res Example: Start Broadcast
Request

curl -X POST "https://api.eyeson.team/rooms/$ACCESS_KEY/broadcasts" \
-H "Content-Type: application/json" \
-d '{"stream_url":"rtmp://a.rtmp.youtube.com/live2/$STREAM_KEY"}'

Response
201

stream_url​

Type: URL (required)
Streaming target URL.

info

Some platforms provide you with a streaming URL and a streaming key. In this case simply append the streaming key to the URL.

player_url​

Type: URL (optional)
Public URL to view the live video.

info

This URL can be found in the Observer's broadcasts_update and the clients console logs.

Update player_url​

PUT /rooms/`ACCESS_KEY`/broadcasts
RESPONSES 200 OK, 400 BAD REQUEST, 404 NOT FOUND, 410 GONE
REQUIRED player_url

player_url​

Type: URL (required)
Public URL to view the live video.

Stop broadcast​

DELETE /rooms/`ACCESS_KEY`/broadcasts
RESPONSES 200 OK, 404 NOT FOUND, 410 GONE
Req/Res Example: Stop Broadcast
Request
curl -X DELETE "https://api.eyeson.team/rooms/$ACCESS_KEY/broadcasts"
Response
200