2.11 Get the Recording File WebRTC Stream URL

Get the WebRTC Stream URL for a Recording File

POSTProduction: https://open.eye4cloud.com/{{open_id}}/open/v1/device/getRecordWebrtcAddress
Request Data
Field Name Required Type Description
device_id Yes string Device ID
timestamp Yes int64 Timestamp in seconds
nonce Yes string Random string, 8-20 characters
sign Yes string See "Sign Generation Examples" for the implementation details
password No string Device password; if omitted, the password registered for the device on the Open Platform is used
record_name Yes string Recording File Name
data No string Device DATA; an empty string can be passed
imei No string Device IMEI; an empty string can be passed
media No int Specify the streaming media server. Omitted or 0 means the China Telecom server; 3 means the China Mobile server.
CURL Request Example
CURL
curl 'https://open.eye4cloud.com/{{open_id}}/open/v1/device/getRecordWebrtcAddress' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "device_id": "xxxx",
    "timestamp": 1758867195,
    "nonce": "",
    "sign": "",
    "record_name": "20251227112834_100.mp4"
}'
Response Data
Field Name Type Description
error_code int Status code: 0 indicates success; other values indicate an error
error_message string Error message; success indicates a normal response
data object Stream URL list (one URL for single-lens devices and multiple URLs for multi-lens devices)
data.list array WebRTC playback URL list (multiple URLs are returned for multi-lens devices)
data.backup_list array Backup Playback URL

Example:

JSON
{
    "error_code": 0,
    "error_message": "success",
    "error_tips": "",
    "data": {
        "list": [
            "https://example.com/DEMO_RESOURCE&nonce=&sign=&stream=DEMO_STREAM_001×tamp=&type=play&vp_openid=",
            "https://example.com/DEMO_RESOURCE&nonce=&sign=&stream=DEMO_STREAM_001×tamp=&type=play&vp_openid="
        ],
        "backup_list": [
            "https://example.com/DEMO_RESOURCE&nonce=&sign=&stream=DEMO_STREAM_001×tamp=&type=play&vp_openid=",
            "https://example.com/DEMO_RESOURCE&nonce=&sign=&stream=DEMO_STREAM_001×tamp=&type=play&vp_openid="
        ]
    }
}