Range

Function

This API is used to get Intercom > CallSetup parameter range.

Request Message

Parameter Description

Table 1
ParameterRangeTypeDescription
channel"CH1"…"CHx"string arrayThe channels supported by the device.

Sample:

POST /API/Intercom/CallSetup/Range HTTP/1.1
{
    "version": "1.0",
    "data": {}
}

Response Message

Parameter Description

Table 2
ParameterRangeTypeDescription
channel_infoobjectTotal channel information see Table 3.
channel_maxintThe maximum number of channels.
Table 3
ParameterRangeTypeDescription
CH1…CHxobjectSee Table 4
Table 4
ParameterRangeTypeDescription
call_settingsobjectCall Settings. See Table 5
sip_settingsobjectSIP Settings. See Table 6
Table 5
ParameterRangeTypeDescription
ringtone"Default"stringRingtone
calling_time_out10-180unsigned intCalling Time Out
touchless_callboolTouchless Call
status_led"Automatic Mode","Stay On","Off"stringStatus LED: Automatic Mode, Stay On, Off
Table 6
ParameterRangeTypeDescription
enable_sipboolEnable SIP
allow_incoming_sip_callsboolAllow Incoming SIP Calls
voip_stream_settings"Substream", "Mainstream", "Thirdstream"stringVOIP Stream Settings
sip_port1-65535unsigned intSIP Port
sip_tls_port1-65535unsigned intSIP TLS Port
rtp_start_port1-65535unsigned intRTP Start Port
iceboolICE
turn_enableboolTURN
turn_server_address0-127stringTURN Server Address
user_name0-127stringUser Name
password0-127stringPassword
stun_enableboolSTUN
stun_server_address0-127stringSTUN Server Address

Sample:

HTTP/1.1 200 OK
Content-Type: application/json
{
    "result": "success",
    "data": {
        "channel_max": 1,
        "channel_info": {
            "type": "object",
            "items": {"CH1": {
                "type": "object",
                "items": {
                    "call_settings": {
                        "type": "object",
                        "items": {
                            "ringtone": {
                                "type": "string",
                                "items": ["Default"]
                            },
                            "calling_time_out": {
                                "type": "uint32",
                                "mode": "r",
                                "min": 10,
                                "max": 180,
                                "default_value": 60
                            },
                            "touchless_call": {"type": "bool"},
                            "status_led": {
                                "type": "string",
                                "mode": "r",
                                "items": [
                                    "Automatic Mode",
                                    "Stay On",
                                    "Off"
                                ]
                            }
                        }
                    },
                    "sip_settings": {
                        "type": "object",
                        "items": {
                            "enable_sip": {"type": "bool"},
                            "allow_incoming_sip_calls": {"type": "bool"},
                            "voip_stream_settings": {
                                "type": "string",
                                "mode": "r",
                                "items": [
                                    "Substream",
                                    "Mainstream",
                                    "Thirdstream"
                                ]
                            },
                            "sip_port": {
                                "type": "int32",
                                "mode": "r",
                                "min": 1,
                                "max": 65535,
                                "default_value": 5060
                            },
                            "sip_tls_port": {
                                "type": "int32",
                                "mode": "r",
                                "min": 1,
                                "max": 65535,
                                "default_value": 5061
                            },
                            "rtp_start_port": {
                                "type": "int32",
                                "mode": "r",
                                "min": 1,
                                "max": 65535,
                                "default_value": 4000
                            },
                            "ice": {"type": "bool"},
                            "turn_enable": {"type": "bool"},
                            "turn_server_address": {
                                "type": "string",
                                "min_len": 0,
                                "max_len": 127
                            },
                            "user_name": {
                                "type": "string",
                                "min_len": 0,
                                "max_len": 127
                            },
                            "password": {
                                "type": "string",
                                "min_len": 0,
                                "max_len": 127
                            },
                            "stun_enable": {"type": "bool"},
                            "stun_server_address": {
                                "type": "string",
                                "min_len": 0,
                                "max_len": 127
                            }
                        }
                    }
                }
            }}
        }
    }
}

Error Code

See Response Messages Body and Common error_code for more information.