Skip to main content
POST
/
api
/
doorbellcamera
/
createSharedLiveVideoStream
Share an live video stream for a doorbell camera
curl --request POST \
  --url https://api2.rhombussystems.com/api/doorbellcamera/createSharedLiveVideoStream \
  --header 'Content-Type: application/json' \
  --header 'x-auth-apikey: <api-key>' \
  --header 'x-auth-scheme: <x-auth-scheme>' \
  --data '
{
  "doorbellCameraUuid": "AAAAAAAAAAAAAAAAAAAAAA.v0",
  "streamType": "USER",
  "vodEnabled": true,
  "audioGatewayUuid": "AAAAAAAAAAAAAAAAAAAAAA.v0",
  "expirationTimeSecs": 86400,
  "invertSchedule": false,
  "name": "Front Door Stream",
  "password": "mypassword123",
  "scheduleUuid": "AAAAAAAAAAAAAAAAAAAAAA"
}
'
{
  "error": true,
  "errorMsg": "<string>",
  "sharedLiveM3U8StreamUrl": "https://example.com/live/m3u8/stream",
  "sharedLiveVideoStreamUrl": "https://example.com/live/video/stream",
  "sharedLiveVideoStreamUuid": "AAAAAAAAAAAAAAAAAAAAAA",
  "warningMsg": "<string>"
}

Authorizations

​
x-auth-apikey
string
header
required

Your API key for Rhombus.

Headers

​
x-auth-scheme
string
default:api-token
required

Authentication scheme indicator ("api-token").

Required string length: 9

Body

application/json

Request object for creating a shared live video stream for a doorbell camera.

​
doorbellCameraUuid
string<DeviceFacetUuid> | null
required

RUUID with optional appended facet information

Example:

"AAAAAAAAAAAAAAAAAAAAAA.v0"

​
streamType
enum<string>
required
Available options:
USER,
ALARM_MONITORING,
DICE,
LUMEO,
INFORMACAST,
RAPIDSOS,
UNKNOWN
​
vodEnabled
boolean | null
required

Enables recording of live footage to a VOD

Example:

true

​
audioGatewayUuid
string<DeviceFacetUuid> | null

RUUID with optional appended facet information

Example:

"AAAAAAAAAAAAAAAAAAAAAA.v0"

​
expirationTimeSecs
integer<int32> | null

Add a expiration date for accessing the stream in seconds

Example:

86400

​
invertSchedule
boolean | null

If given a schedule uuid, will hide the stream during the schedule instead and show it otherwise

Example:

false

​
name
string | null

If not provided, will be named 'Unnamed'

Example:

"Front Door Stream"

​
password
string | null

Add a password to allow access to your shared stream. If null or blank password is not set.

Example:

"mypassword123"

​
scheduleUuid
string<RUUID> | null

base 64 (url-safe) uuid string

Example:

"AAAAAAAAAAAAAAAAAAAAAA"

Response

200 - application/json

OK

Response object for creating a shared live video stream for a doorbell camera.

​
error
boolean | null
​
errorMsg
string | null
​
sharedLiveM3U8StreamUrl
string | null

M3U8 URL for the shared live video stream

Example:

"https://example.com/live/m3u8/stream"

​
sharedLiveVideoStreamUrl
string | null

URL for the shared live video stream

Example:

"https://example.com/live/video/stream"

​
sharedLiveVideoStreamUuid
string<RUUID> | null

base 64 (url-safe) uuid string

Example:

"AAAAAAAAAAAAAAAAAAAAAA"

​
warningMsg
string | null