Skip to content

Get camera media URIs

Get media uris for camera to retrieve footage

POST/api/camera/getMediaUris

Authorizations

x-auth-apikeystringheaderrequired

Your Rhombus API key. Must be accompanied by the x-auth-scheme header set to api-token (or partner-api-token for partner endpoints).

Authorizationstringheader

Instead of an API key, an OAuth access token: Bearer <token>, with the read scope.

OAuth explains tokens and scopes.

Headers

x-auth-schemeenum<string>headerdefault: api-token

Authentication scheme identifier. Use api-token or partner-api-token with the x-auth-apikey header, api or partner-api with x-auth-apikey plus a client certificate, api-oauth-token or partner-api-oauth-token with x-auth-access-token, and federated-token with x-auth-ft. A request with Authorization: Bearer <token> and no x-auth-scheme is treated as OAuth, and federated-token may also be sent as the x-auth-scheme and x-auth-ft query parameters.

Available options: api-token, api, api-oauth-token, federated-token, partner-api-token, partner-api, partner-api-oauth-token

x-auth-orgstring<RUUID>header

Client organization UUID (22-character RUUID), for partner credentials only. With it the call runs in that client organization with the partner support authority's role. Without it a partner credential runs as the partner organization, which outside the partner endpoints is deprecated (responses carry Deprecation and Sunset: Tue, 05 Jan 2027 00:00:00 GMT). A malformed value returns 400 INVALID_AUTH_ORG; a client organization the partner cannot access returns 403 PARTNER_CLIENT_ACCESS_DENIED.

Length: 22 to 22

Body

application/json · object

Request to get media URIs for a camera device.

cameraUuidstring<DeviceFacetUuid> | nullbody

RUUID with optional appended facet information

Example: "AAAAAAAAAAAAAAAAAAAAAA.v0"

includePtzCapabilitiesboolean | nullbody

Response

200 OK

application/json · object

Response containing media URIs for camera streaming and playback.

errorboolean | null
errorCodestring | null

Stable, machine-readable code for the failure (one of the ApiErrorCode catalog) when error is true. Branch on this, not on errorMsg.

errorMsgstring | null
lanCheckUrlsstring[] | null

List of LAN check URLs to verify device availability

lanLiveH264Urisstring[] | null

List of LAN H.264 live streaming URIs

lanLiveM3u8Urisstring[] | null

List of LAN M3U8 live streaming URIs

lanLiveMpdUrisstring[] | null

List of LAN MPD live streaming URIs

lanLiveOpusUrisstring[] | null

List of LAN URIs for live Opus audio streams

lanVodM3u8UrisTemplatesstring[] | null

List of LAN M3U8 VOD URI templates

lanVodMpdUrisTemplatesstring[] | null

List of LAN MPD VOD URI templates

ptzCapabilitiesobject
Show child attributes
continuousPanTiltboolean | null
continuousZoomboolean | null
realtimePtzboolean | null
reportobject

A WebAuthn credential auth response

wanLiveH264Uristring | null

WAN H.264 live streaming URI

Example: "rtsp://camera.example.com/live"

wanLiveM3u8Uristring | null

WAN M3U8 live streaming URI

Example: "https://camera.example.com/live.m3u8"

wanLiveMpdUristring | null

WAN MPD live streaming URI

Example: "https://camera.example.com/live.mpd"

wanLiveOpusUristring | null

WAN URI for live Opus audio stream

wanPtzControlUristring | null
wanVodH264UriTemplatestring | null

WAN H.264 VOD URI template

Example: "https://camera.example.com/vod/{timestamp}.h264"

wanVodM3u8UriTemplatestring | null

WAN M3U8 VOD URI template

Example: "https://camera.example.com/vod/{timestamp}.m3u8"

wanVodMpdUriTemplatestring | null

WAN MPD VOD URI template

Example: "https://camera.example.com/vod/{timestamp}.mpd"

warningMsgstring | null

Errors

Like every operation, this one can also answer with the standard error body (errorCode, errorMsg). Errors explains each status and how to retry.

  • 400 Bad Request. errorCode is one of: BAD_REQUEST, VALIDATION_FAILED, MISSING_REQUIRED_FIELD, INVALID_JSON, INVALID_REQUEST_BODY, FEATURE_NOT_ENABLED, INVALID_AUTH_ORG, LOCATION_NOT_FOUND, SELF_PROVISIONING_DISABLED, SKU_NOT_ALLOWED, QUANTITY_INVALID, AUTO_RENEW_REQUIRED, PROVISION_CAP_EXCEEDED, ACKNOWLEDGEMENT_REQUIRED, SIGNATURE_REQUIRED, APEX_VALIDATION, SKU_NOT_IN_PRICEBOOK.
  • 401 Unauthorized. errorCode is one of: UNAUTHENTICATED, INVALID_CREDENTIAL, CREDENTIAL_EXPIRED, CREDENTIAL_REVOKED, CERTIFICATE_MISMATCH.
  • 403 Forbidden. errorCode is one of: FORBIDDEN, DOMAIN_NOT_ALLOWED, DEVICE_SCOPE_MISMATCH, ROLE_NOT_PERMITTED, FUNCTIONALITY_REQUIRED, PARTNER_FUNCTIONALITY_REQUIRED, PERMISSION_REQUIRED, PARTNER_CLIENT_ACCESS_DENIED, HARDWARE_NOT_AVAILABLE, HARDWARE_ALREADY_REGISTERED, PARTNER_PORTAL_NOT_ENABLED, MANAGED_BY_MSP, SUPER_ADMIN_RESTRICTED_BY_MSP, MSP_DESIGNATION_INVALID, NOT_MANAGED_CLIENT, NOT_VERIFIED_MSP, ORDER_NOT_YOURS.
  • 429 Too Many Requests. errorCode is one of: RATE_LIMITED, QUOTE_RATE_LIMITED.
  • 500 Internal Server Error. errorCode is one of: INTERNAL_ERROR.
  • 503 Service Unavailable. errorCode is one of: SERVICE_UNAVAILABLE, SALESFORCE_UNAVAILABLE.