Devices

ICE servers for a WebRTC viewer of this device: the TURN of the device's host with a temporary credential (read key is enough)

Pass them as RTCPeerConnection({iceServers}) before POST …/stream. Needed behind VPNs that block non-proxied UDP and strict NATs; empty when the host has no TURN. The credential lives ttl seconds - ask again before it expires.

get/devices/{name}/ice

Request

  • Base URL: https://api.clousd.com/v1
  • URL: https://api.clousd.com/v1/devices/{name}/ice
  • Auth: HTTP bearer

Query parameters

viewerstring

Viewer id, as in stream stats

Response

ICE servers

okboolean
ttlinteger

Credential lifetime in seconds (0 = no TURN)

Example response

{
  "ice_servers": [
    {
      "urls": [
        "turn:stream.clousd.com:3478?transport=udp",
        "turns:stream.clousd.com:5349?transport=tcp"
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.