HTTP API manual for 2N

IP intercoms

Configuration Manual

Version: 2.23 www.2n.cz

The 2N TELEKOMUNIKACE a.s. is a Czech manufacturer and supplier of
telecommunications equipment.

The product family developed by 2N TELEKOMUNIKACE a.s. includes GSM gateways,

private branch exchanges (PBX), and door and lift communicators. 2N
TELEKOMUNIKACE a.s. has been ranked among the Czech top companies for years
and represented a symbol of stability and prosperity on the telecommunications
market for almost two decades. At present, we export our products into over 120
countries worldwide and have exclusive distributors on all continents.

2N ® is a registered trademark of 2N TELEKOMUNIKACE a.s. Any product and/or other

names mentioned herein are registered trademarks and/or trademarks or brands
protected by law.

2N TELEKOMUNIKACE a.s. administers the FAQ database to help you quickly find
information and to answer your questions about 2N products and services. On www.
faq.2n.cz you can find information regarding products adjustment and instructions for
optimum use and procedures „What to do if...".

2N TELEKOMUNIKACE a.s. hereby declares that the 2N ® product complies with all
basic requirements and other relevant provisions of the 1999/5/EC directive. For the
full wording of the Declaration of Conformity see the CD-ROM (if enclosed) or our
website at www.2n.cz.

This device complies with part 15 of the FCC Rules. Operation is subject to the
following two conditions: (1) This device may not cause harmful interference, and (2)
this device must accept any interference received, including interference that may
cause undesired operation.
The 2N TELEKOMUNIKACE a.s. is the holder of the ISO 9001:2009 certificate. All
development, production and distribution processes of the company are managed by
this standard and guarantee a high quality, technical level and professional aspect of
all our products.
Content:

1. Introduction
2. HTTP API Description
3. HTTP API Services Security
4. User Accounts
5. Overview of HTTP API Functions

2N TELEKOMUNIKACE a.s., www.2n.cz 4/104

1. Introduction

HTTP API is an application interface designed for control of selected 2N IP intercoms

functions via the HTTP. It enables 2N IP intercoms to be integrated easily with third
party products, such as home automation, security and monitoring systems, etc.

HTTP API provides the following services:

System API – provides intercom configuration changes, status info and upgrade.
Switch API – provides switch status control and monitoring, e.g. door lock
opening, etc.
I/O API – provides intercom logic input/output control and monitoring.
Audio API – provides audio playback control and microphone monitoring.
Camera API – provides camera image control and monitoring.
Display API – provides display control and user information display.
E-mail API – provides sending of user e-mails.
Phone/Call API – provides incoming/outgoing call control and monitoring.
Logging API – provides reading of event records.

Set the transport protocol (HTTP or HTTPS) and way of authentication (None, Basic or
Digest) for each function. Create up to five user accounts (with own username and
password) in the HTTP API configuration for detailed access control of services and
functions.

Use the configuration web interface on the Services / HTTP API tab to configure your
HTTP API. Enable and configure all the available services and set the user account
parameters.

Refer to http(s)://ip_intercom_address/apitest.html for a special tool integrated in the

intercom HTTP server for HTTP API demonstration and testing.

2N TELEKOMUNIKACE a.s., www.2n.cz 5/104

1.1 HTTP API Release Notes
Version Changes

2.23
Addition of the switchDisabled parametr to UserRejected event.

2.22
New events: CardHeld, PairingStateChanged, SwitchesBlocked, FingerEntered,
MobKeyEntered, DoorStateChanged, UserRejected, DisplayTouched.

2.21
The api/display/image (display, blob-image, blob-video, duration, repeat

parameters) function extended for 2N ® IP Verso

New events: UserAuthenticated, SilentAlarm, AccessLimited

Addition of the timeSpan parameter to the /api/email/send function

2.15
New events: TamperSwitchActivated, UnauthorizedDoorOpen,
DoorOpenTooLong and LoginBlocked

Addition of the tzShift event that gives the difference between the local time
and Coordinated Universal Time (UTC)

The email/send function extended with a resolution setting option for the
images to be sent

2.14
Addition of the api/pcap, api/pcap/restart and api/pcap/stop functions for
network traffic download and control

Addition of the audio/test function for automatic audio test launch

Addition of the email/send function

Addition of the response parameter to the /api/io/ctrl and /api/switch/ctrl

functions

The /call/hangup function extended with a reason parameter specifying the call
end reason

New events: MotionDetected, NoiseDetected and SwitchStateChanged

The CallStateChanged event extended with a reason parameter specifying the

call end reason

2.13
First document version

2N TELEKOMUNIKACE a.s., www.2n.cz 6/104

2. HTTP API Description

All HTTP API commands are sent via HTTP/HTTPS to the intercom address with
absolute path completed with the /api prefix. Which protocol you choose depends on
the current intercom settings in the Services / HTTP API section. The HTTP API
functions are assigned to services with defined security levels including the TLS
connection request (i.e. HTTPS).

Example: Switch 1 activation http://10.0.23.193/api/switch/ctrl?switch=1&action=on

The absolute path includes the function group name (system, firmware, config, switch,
etc.) and the function name (caps, status, ctrl, etc.).
To be accepted by the intercom, a request has to include the method and absolute
path specification followed by the Host header.

Example:

GET /api/system/info HTTP/1.1

Host: 10.0.23.193
Intercom HTTP Server reply:
HTTP/1.1 200 OK
Server: HIP2.10.0.19.2
Content-Type: application/json
Content-Length: 253
{
"success" : true,
"result" : {
"variant" : "2N Helios IP Vario",
"serialNumber" : "08-1860-0035",
"hwVersion" : "535v1",
"swVersion" : "2.10.0.19.2",
"buildType" : "beta",
"deviceName" : "2N Helios IP Vario"
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 7/104

This chapter also includes:

2.1 HTTP Methods

2.2 Request Parameters
2.3 Replies to Requests

2N TELEKOMUNIKACE a.s., www.2n.cz 8/104

2.1 HTTP Methods
2N IP intercom applies the following four HTTP methods:

GET – requests intercom content download or general command execution

POST – requests intercom content download or general command execution
PUT – requests intercom content upload
DELETE – requests intercom content removal

The GET and POST methods are equivalent from the viewpoint of HTTP API but use
different parameter transfers (refer to the next subsection). The PUT and DELETE
methods are used for handling of such extensive objects as configuration, firmware,
images and sound files.

2N TELEKOMUNIKACE a.s., www.2n.cz 9/104

2.2 Request Parameters
Practically all the HTTP API functions can have parameters. The parameters (switch,
action, width, height, blob-image, etc.) are included in the description of the selected
HTTP API function. The parameters can be transferred in three ways or their
combinations:

1. in the request path (uri query, GET, POST, PUT and DELETE methods);

2. in the message content (application/x-www-form-urlencoded, POST and PUT

methods);

3. in the message content (multipart/form-data, POST and PUT methods) – RFC-

1867.

If the transfer methods are combined, a parameter may occur more times in the
request. In that case, the last incidence is preferred.

There are two types of the HTTP API parameters:

1. Simple value parameters (switch, action, etc.) can be transferred using any of the
above listed methods and do not contain the blob- prefix.

2. Large data parameters (configuration, firmware, images, etc.) always start with
blob- and can only be transferred via the last-named method (multipart/form-
data).

2N TELEKOMUNIKACE a.s., www.2n.cz 10/104

2.3 Replies to Requests
Replies to requests are mostly in the JSON format. Binary data download (user
sounds, images, etc.) and intercom configuration requests are in XML. The Content-
Type header specifies the response format. Three basic reply types are defined for
JSON.

Positive Reply without Parameters

This reply is sent in case a request has been executed successfully for functions that
do not return any parameters. This reply is always combined with the HTTP status
code 200 OK.

{
"success" : true,
}

Positive Reply with Parameters

This reply is sent in case a request has been executed successfully for functions that
return supplementary parameters. The result item includes other reply parameters
related to the function. This reply is always combined with the HTTP status code 200
OK.

{
"success" : true,
"result" : {
...
}
}

Negative Reply at Request Error

This reply is sent in case an error occurs during request processing. The reply specifies
the error code (code), text description (description) and error details if necessary (
param). The reply can be combined with the HTTP status code 200 OK or 401
Authorisation Required.

2N TELEKOMUNIKACE a.s., www.2n.cz 11/104

 {
"success" : false,
"error" : {
"code" : 12,
"param" : "port",
"description" : "invalid parameter value"
}
}

The table below includes a list of available error codes.

Code Description  

1 function is not The requested function is unavailable in this model.

supported

2 invalid The absolute path specified in the HTTP request does not match any of
request path the HTTP API functions.

3 invalid The HTTP method used is invalid for the selected function.
request
method

4 function is The function (service) is disabled. Enable the function on the Services /
disabled HTTP API configuration interface page.

5 function is The function (service) is subject to licence and available with a licence
licensed key only.

7 invalid HTTPS connection is required.

connection
type

8 invalid The authentication method used is invalid for the selected service. This
authentication error happens when the Digest method is only enabled for the service
method but the client tries to authenticate via the Basic method.

9 authorisation User authorisation is required for the service access. This error is sent
required together with the HTTP status code Authorisation Required.

2N TELEKOMUNIKACE a.s., www.2n.cz 12/104

Code Description  

10 insufficient The user to be authenticated has insufficient privileges for the function.
user
privileges

11 missing The request lacks a mandatory parameter. Refer to param for the
mandatory parameter name.
parameter

12 invalid A parameter value is invalid. Refer to param for the parameter name.
parameter
value

13 parameter The parameter data exceed the acceptable limit. Refer to param for the
data too big parameter name.

14 unspecified An unspecified error occurred during request processing.

processing
error

15 no data The required data are not available on the server.

available

2N TELEKOMUNIKACE a.s., www.2n.cz 13/104

3. HTTP API Services Security

Set the security level for each HTTP API service via the 2N IP intercom configuration
web interface on the Services / HTTP API tab: disable/enable a service and select the
required communication protocol and user authentication method.

Set the required transport protocol for each service separately:

HTTP – send requests via HTTP or HTTPS. Both the protocols are enabled and
the security level is defined by the protocol used.
HTTPS – send requests via HTTPS. Any requests sent via the unsecured HTTP
are rejected by the intercom. HTTPS secures that no unauthorised person may
read the contents of sent/received messages.

2N TELEKOMUNIKACE a.s., www.2n.cz 14/104

Set authentication methods for the requests to be sent to the intercom for each
service. If the required authentication is not executed, the request will be rejected.
Requests are authenticated via a standard authentication protocol described in RFC-
2617. The following three authentication methods are available:

None – no authentication is required. In this case, this service is completely

unsecure in the LAN.
Basic – Basic authentication is required according to RFC-2617. In this case, the
service is protected with a password transmitted in an open format. Thus, we
recommend you to combine this option with HTTPS where possible.
Digest – Digest authentication is required according to RFC-2617. This is the
default and most secure option of the three above listed methods.

We recommend you to use the HTTPS + Digest combination for all the services to
achieve the highest security and avoid misuse. If the other party does not support this
combination, the selected service can be granted a dispensation and assigned a lower
security level.

2N TELEKOMUNIKACE a.s., www.2n.cz 15/104

4. User Accounts

With 2N IP intercom you can administer up to five user accounts for access to the
HTTP API services. The user account contains the user's name, password and HTTP API
access privileges.

Use the table above to control the user account privileges to the HTTP API services.

2N TELEKOMUNIKACE a.s., www.2n.cz 16/104

5. Overview of HTTP API
Functions

The table below provides a list of all available HTTP API functions including:

the HTTP request absolute path;

the supported HTTP methods;
the service in which the function is included;
the required user privileges (if authentication is used);
the required licence (Enhanced Integration licence key).

Absolute path Method Service Privileges Licence

/api/system/info GET/POST System System Control No

/api/system/status GET/POST System System Control Yes

/api/system/restart GET/POST System System Control Yes

/api/firmware PUT System System Control Yes

/api/firmware/apply GET/POST System System Control Yes

/api/config GET/POST/PUT System System Control Yes

/api/config/factoryreset GET/POST System System Control Yes

/api/switch/caps GET/POST Switch Switch Monitoring Yes

/api/switch/status GET/POST Switch Switch Monitoring Yes

/api/switch/ctrl GET/POST Switch Switch Control Yes

2N TELEKOMUNIKACE a.s., www.2n.cz 17/104

Absolute path Method Service Privileges Licence

/api/io/caps GET/POST I/O I/O Monitoring Yes

/api/io/status GET/POST I/O I/O Monitoring Yes

/api/io/ctrl GET/POST I/O I/O Control Yes

/api/phone/status GET/POST Phone/Call Call Monitoring Yes

/api/call/status GET/POST Phone/Call Call Monitoring Yes

/api/call/dial GET/POST Phone/Call Call Control Yes

/api/call/answer GET/POST Phone/Call Call Control Yes

/api/call/hangup GET/POST Phone/Call Call Control Yes

/api/camera/caps GET/POST Camera Camera Monitoring No

/api/camera/snapshot GET/POST Camera Camera Monitoring No

/api/display/caps GET/POST Display Display Control Yes

/api/display/image PUT/DELETE Display Display Control Yes

/api/log/caps GET/POST Logging * No

/api/log/subscribe GET/POST Logging * No

/api/log/unsubscribe GET/POST Logging * No

/api/log/pull GET/POST Logging * No

/api/audio/test GET/POST Audio Audio Control Yes

/api/email/send GET/POST E-mail E-mail Control Yes

/pcap GET/POST System System Control Yes

2N TELEKOMUNIKACE a.s., www.2n.cz 18/104

Absolute path Method Service Privileges Licence

/pcap/restart GET/POST System System Control Yes

/pcap/stop GET/POST System System Control Yes

This chapter also includes:

5.1 api system info

5.2 api system status
5.3 api system restart
5.4 api firmware
5.5 api firmware apply
5.6 api config
5.7 api config factoryreset
5.8 api switch caps
5.9 api switch status
5.10 api switch ctrl
5.11 api io caps
5.12 api io status
5.13 api io ctrl
5.14 api phone status
5.15 api call status
5.16 api call dial
5.17 api call answer
5.18 api call hangup
5.19 api camera caps
5.20 api camera snapshot
5.21 api display caps
5.22 api display image
5.23 api log caps
5.24 api log subscribe
5.25 api log unsubscribe
5.26 api log pull
5.27 api audio test
5.28 api email send
5.29 api pcap
5.30 api pcap restart

2N TELEKOMUNIKACE a.s., www.2n.cz 19/104

 5.31 api pcap stop

2N TELEKOMUNIKACE a.s., www.2n.cz 20/104

5.1 api system info
The /api/system/info function provides basic information on the device: type, serial
number, firmware version, etc. The function is available in all device types regardless
of the set access rights.

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format and includes the following information on
the device:

Parameter Description

variant Model name (version)

serialNumber Serial number

hwVersion Hardware version

swVersion Firmware version

buildType Firmware build type (alpha, beta, or empty value for official versions)

deviceName Device name set in the configuration interface on the Services / Web Server tab

Example:

GET /api/system/info
{
"success" : true,
"result" : {
"variant" : "2N Helios IP Vario",
"serialNumber" : "08-1860-0035",
"hwVersion" : "535v1",
"swVersion" : "2.10.0.19.2",
"buildType" : "beta",
"deviceName" : "2N Helios IP Vario"
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 21/104

5.2 api system status
The /api/system/status function returns the current intercom status.

The function is part of the System service and the user must be assigned the System
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format and includes the current device status.

Parameter Description

systemTime Device real time in seconds since 00:00 1.1.1970 (unix time)

upTime Device operation time since the last restart in seconds

Example:

GET /api/system/status
{
"success" : true,
"result" : {
"systemTime" : 1418225091,
"upTime" : 190524
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 22/104

5.3 api system restart
The /api/system/restart restarts the intercom.

The function is part of the System service and the user must be assigned the System
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format and includes no parameters.

Example:

GET /api/system/restart
{
"success" : true
}

2N TELEKOMUNIKACE a.s., www.2n.cz 23/104

5.4 api firmware
The /api/firmware function helps you upload a new firmware version to the device.
When the upload is complete, use /api/firmware/apply to confirm restart and FW
change.

The function is part of the System service and the user must be assigned the System
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The PUT method can only be used for this function.

Request parameters:

Parameter Description

blob-fw Mandatory parameter including device FW

The reply is in the application/json format and includes information on the FW to be

uploaded.

Parameter Description

version Firmware version to be uploaded

downgrade Flag set if the FW to be uploaded is older than the current one

Example:

PUT /api/firmware
{
"success" : true,
"result" : {
"version" : "2.10.0.19.2",
"downgrade" : false
}
}

If the FW file to be uploaded is corrupted or not intended for your device, the
intercom returns error code 12 – invalid parameter value.

2N TELEKOMUNIKACE a.s., www.2n.cz 24/104

5.5 api firmware apply
The /api/firmware/apply function is used for earlier firmware upload (PUT /api
/firmware) confirmation and subsequent device restart.

The function is part of the System service and the user must be assigned the System
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format and includes no parameters.

Example:

GET /api/firmware/apply
{
"success" : true
}

2N TELEKOMUNIKACE a.s., www.2n.cz 25/104

5.6 api config
The /api/config function helps you upload or download device configuration.

The function is part of the System service and the user must be assigned the System
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

Use the GET or POST method for configuration download and PUT method for
configuration upload.

Request parameters for PUT:

Parameter Description

blob-cfg Mandatory parameter including device configuration (XML)

No parameters are defined for the GET/POST methods.

For configuration download, the reply is in the application/xml format and contains a
complete device configuration file.

The /api/config function using the PUT method uploads configuration with a delay of
approx. 15 s; do not reset or switch off the intercom during this interval.

Example:

GET /api/config
<?xml version="1.0" encoding="UTF-8"?>
<!--
Product name: 2N Helios IP Vario
Serial number: 08-1860-0035
Software version: 2.10.0.19.2
Hardware version: 535v1
Bootloader version: 2.10.0.19.1
Display: No
Card reader: No
-->
<DeviceDatabase Version="4">
<Network>
<DhcpEnabled>1</DhcpEnabled>
...
...

2N TELEKOMUNIKACE a.s., www.2n.cz 26/104

For configuration upload, the reply is in the application/json format and includes no
other parameters.

Example:

PUT /api/config
{
"success" : true
}

2N TELEKOMUNIKACE a.s., www.2n.cz 27/104

5.7 api config factoryreset
The /api/config/factoryreset function resets the factory default values for all the
intercom parameters. This function is equivalent to the function of the same name in
the System / Maintenance / Default setting section of the configuration web interface.

The function is part of the System service and the user must be assigned the System
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format and includes no parameters.

The /api/config/factoryreset function resets the intercom factory values with a delay
of approx. 15 s; do not reset or switch off the intercom during this interval.

Example:

GET /api/config/factoryreset
{
"success" : true
}

2N TELEKOMUNIKACE a.s., www.2n.cz 28/104

5.8 api switch caps
The /api/switch/caps function returns the current switch settings and control options.
Define the switch in the optional switch parameter. If the switch parameter is not
included, settings of all the switches are returned.

The function is part of the Switch service and the user must be assigned the Switch
Monitoring privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

switch Optional switch identifier (typically, 1 to 4)

The reply is in the application/json format and includes a switch list (switches)
including current settings. If the switch parameter is used, the switches field includes
just one item.

Parameter Description

switch Switch Id (1 to 4)

enabled Switch control enabled in the configuration web interface

mode Selected switch mode (monostable, bistable)

switchOnDuration Switch activation time in seconds (for monostable mode only)

type Switch type (normal, security)

2N TELEKOMUNIKACE a.s., www.2n.cz 29/104

Example:

GET /api/switch/caps
{
"success" : true,
"result" : {
"switches" : [
{
"switch" : 1,
"enabled" : true,
"mode" : "monostable",
"switchOnDuration" : 5,
"type" : "normal"
},
{
"switch" : 2,
"enabled" : true,
"mode" : "monostable",
"switchOnDuration" : 5,
"type" : "normal"
},
{
"switch" : 3,
"enabled" : false
},
{
"switch" : 4,
"enabled" : false
}
]
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 30/104

5.9 api switch status
The /api/switch/status function returns the current switch statuses. Define the switch
in the optional switch parameter. If the switch parameter is not included, states of all
the switches are returned.

The function is part of the Switch service and the user must be assigned the Switch
Monitoring privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

switch Optional switch identifier (typically, 1 to 4). Use also /api/switch/caps to know the
exact count of switches.

The reply is in the application/json format and includes a switch list (switches)
including current statuses (active). If the switch parameter is used, the switches field
includes just one item.

2N TELEKOMUNIKACE a.s., www.2n.cz 31/104

Example:

GET /api/switch/status
{
"success" : true,
"result" : {
"switches" : [
{
"switch" : 1,
"active" : false
},
{
"switch" : 2,
"active" : false
},
{
"switch" : 3,
"active" : false
}
]
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 32/104

5.10 api switch ctrl
The /api/switch/ctrl function controls the switch statuses. The function has two
mandatory parameters: switch, which determines the switch to be controlled, and
action, defining the action to be executed over the switch (activation, deactivation,
state change).

The function is part of the Switch service and the user must be assigned the Switch
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

switch Mandatory switch identifier (typically, 1 to 4). Use also /api/switch/caps to know the
exact count of switches.

action Mandatory action defining parameter (on – activate switch, off – deactivate switch,
trigger – change switch state).

response Optional parameter modifying the intercom response to include the text defined
here instead of the JSON message.

The reply is in the application/json format and includes no parameters.

Example:

GET /api/switch/ctrl?switch=1&action=trigger
{
"success" : true
}

If the response parameter is used, the reply does not include the json messages; the
server returns a text/plain reply with the specified text (which can be empty).

2N TELEKOMUNIKACE a.s., www.2n.cz 33/104

Example:

GET /api/switch/ctrl?switch=1&action=on&response=text
text

GET /api/switch/ctrl?switch=1&action=on&response=

2N TELEKOMUNIKACE a.s., www.2n.cz 34/104

5.11 api io caps
The /api/io/caps function returns a list of available hardware inputs and outputs
(ports) of the device. Define the input/output in the optional port parameter. If the
port parameter is not included, settings of all the inputs and outputs are returned.

The function is part of the I/O service and the user must be assigned the I/O
Monitoring privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

Port Optional input/output identifier

The reply is in the application/json format and includes a port list (ports) including
current settings. If the port parameter is used, the ports field includes just one item.

Parameter Description

port Input/output identifier

type Type (input – for digital inputs, output – for digital outputs)

2N TELEKOMUNIKACE a.s., www.2n.cz 35/104

Example:

GET /api/io/caps
{
"success" : true,
"result" : {
"ports" : [
{
"port" : "relay1",
"type" : "output"
},
{
"port" : "relay2",
"type" : "output"
}
]
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 36/104

5.12 api io status
The /api/io/status function returns the current statuses of logic inputs and outputs
(ports) of the device. Define the input/output in the optional port parameter. If the
port parameter is not included, statuses of all the inputs and outputs are returned.

The function is part of the I/O service and the user must be assigned the I/O
Monitoring privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

port Optional input/output identifier. Use also /api/io/caps to get identifiers of the
available inputs and outputs.

The reply is in the application/json format and includes a port list (ports) including
current settings (state). If the port parameter is used, the ports field includes just one
item.

Example:

GET /api/io/status
{
"success" : true,
"result" : {
"ports" : [
{
"port" : "relay1",
"state" : 0
},
{
"port" : "relay2",
"state" : 0
}
]
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 37/104

5.13 api io ctrl
The /api/io/ctrl function controls the statuses of the device logic outputs. The
function has two mandatory parameters: port, which determines the output to be
controlled, and action, defining the action to be executed over the output (activation,
deactivation).

The function is part of the I/O service and the user must be assigned the I/O Control
privilege for authentication if required. The function is available with the Enhanced
Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

port Mandatory I/O identifier. Use also /api/io/caps to get the identifiers of the available
inputs and outputs.

action Mandatory action defining parameter (on – activate output, log. 1, off – deactivate
output, log. 0)

response Optional parameter modifying the intercom response to include the text defined
here instead of the JSON message.

The reply is in the application/json format and includes no parameters.

Example:

GET /api/io/ctrl?port=relay1&action=on
{
"success" : true
}

If the response parameter is used, the reply does not include the json messages; the
server returns a text/plain reply with the specified text (which can be empty).

2N TELEKOMUNIKACE a.s., www.2n.cz 38/104

Example:

GET /api/io/ctrl?port=relay1&action=on&response=text
text

GET /api/io/ctrl?port=relay1&action=on&response=

2N TELEKOMUNIKACE a.s., www.2n.cz 39/104

5.14 api phone status
The /api/phone/status functions helps you get the current statuses of the device SIP
accounts.

The function is part of the Phone/Call service and the user must be assigned the Phone
/Call Monitoring privilege for authentication if required. The function is available with
the Enhanced Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

account Optional SIP account identifier (1 or 2). If the parameter is not included, the function
returns statuses of all the SIP accounts.

The reply is in the application/json format and includes a list of device SIP accounts (
accounts) including current statuses. If the account parameter is used, the accounts
field includes just one item.

Parameter Description

account Unique SIP account identifier (1 or 2)

sipNumber SIP account telephone number

registered Account registration with the SIP Registrar

registerTime Last successful registration time in seconds since 00:00 1.1.1970 (unix time)

2N TELEKOMUNIKACE a.s., www.2n.cz 40/104

Example:

GET /api/phone/status
{
"success" : true,
"result" : {
"accounts" : [
{
"account" : 1,
"sipNumber" : "5046",
"registered" : true,
"registerTime" : 1418034578
},
{
"account" : 2,
"sipNumber" : "",
"registered" : false
}
]
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 41/104

5.15 api call status
The /api/call/status function helps you get the current states of active telephone calls.
The function returns a list of active calls including parameters.

The function is part of the Phone/Call service and the user must be assigned the Phone
/Call Monitoring privilege for authentication if required. The function is available with
the Enhanced Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

session Optional call identifier. If the parameter is not included, the function returns statuses
of all the active calls.

The reply is in the application/json format and includes a list of active calls (sessions)
including their current states. If the session parameter is used, the sessions field
includes just one item. If there is no active call, the sessions field is empty.

Parameter Description

session Call identifier

direction Call direction (incoming, outgoing)

state Call state (connecting, ringing, connected)

2N TELEKOMUNIKACE a.s., www.2n.cz 42/104

Example:

GET /api/call/status
{
"success" : true,
"result" : {
"sessions" : [
{
"session" : 1,
"direction" : "outgoing",
"state" : "ringing"
}
]
}

2N TELEKOMUNIKACE a.s., www.2n.cz 43/104

5.16 api call dial
The /api/call/dial function initiates a new outgoing call to a selected phone number or
sip uri.

The function is part of the Phone/Call service and the user must be assigned the Phone
/Call Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

number Mandatory parameter specifying the destination phone number or sip uri

The reply is in the application/json format and includes information on the outgoing
call created.

Parameter Description

session Call identifier, used, for example, for call monitoring with /api/call/status or call
termination with /api/call/hangup

Example:

GET /api/call/dial?number=sip:[email protected]
{
"success" : true,
"result" : {
"session" : 2
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 44/104

5.17 api call answer
The /api/call/answer function helps you answer an active incoming call (in the ringing
state).

The function is part of the Phone/Call service and the user must be assigned the Phone
/Call Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

session Active incoming call identifier

The reply is in the application/json format and includes no parameters.

Example:

GET /api/call/answer?session=3
{
"success" : true
}

2N TELEKOMUNIKACE a.s., www.2n.cz 45/104

5.18 api call hangup
The /api/call/hangup helps you hang up an active incoming or outgoing call.

The function is part of the Phone/Call service and the user must be assigned the Phone
/Call Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

session Active incoming/outgoing call identifier

reason End call reason:

normal – normal call end (default value)

rejected – call rejection signalling

busy – station busy signalling

The reply is in the application/json format and includes no parameters.

Example:

GET /api/call/hangup?session=4
{
"success" : true
}

2N TELEKOMUNIKACE a.s., www.2n.cz 46/104

5.19 api camera caps
The /api/camera/caps function returns a list of available video sources and resolution
options for JPEG snapshots to be downloaded via the /api/camera/snapshot function.

The function is part of the Camera service and the user must be assigned the Camera
Monitoring privilege for authentication if required.

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format and includes a list of supported resolutions
of JPEG snapshots (jpegResolution) and a list of available video sources (sources),
which can be used in the /api/camera/snapshot parameters.

Parameter Description

width, height Snapshot resolution in pixels

source Video source identifier

2N TELEKOMUNIKACE a.s., www.2n.cz 47/104

Example:

GET /api/camera/caps
{
"success" : true,
"result" : {
"jpegResolution" : [
{
"width" : 160,
"height" : 120
},
{
"width" : 176,
"height" : 144
},
{
"width" : 320,
"height" : 240
},
{
"width" : 352,
"height" : 272
},
{
"width" : 352,
"height" : 288
},
{
"width" : 640,
"height" : 480
}
],
"sources" : [
{
"source" : "internal"
},
{
"source" : "external"
}
]
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 48/104

5.20 api camera snapshot
The /api/camera/snapshot function helps you download images from an internal or
external IP camera connected to the intercom. Specify the video source, resolution
and other parameters.

The function is part of the Camera service and the user must be assigned the Camera
Monitoring privilege for authentication if required.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

width Mandatory parameter specifying the horizontal resolution of the JPEG image in
pixels

height Mandatory parameter specifying the vertical resolution of the JPEG image in pixels.
The snapshot height and width must comply with one of the supported options (see
api/camera/caps).

source Optional parameter defining the video source (internal – internal camera, external –
external IP camera). If the parameter is not included, the default video source
included in the Hardware / Camera / Common settings section of the configuration
web interface is selected.

fps Optional parameter defining the frame rate. If the parameter is set to >= 1, the
intercom sends images at the set frame rate using the http server push method.

time Optional parameter defining the snapshot time in the intercom memory. The time
values must be within the intercom memory range: <-30, 0> seconds. When this
parameter is used together with the fps parameter, the fps parameter is ignored and
function returns only a single frame.

The reply is in the image/jpeg or multipart/x-mixed-replace (pro fps >= 1) format. If

the request parameters are wrong, the function returns information in the application
/json format.

Example:

2N TELEKOMUNIKACE a.s., www.2n.cz 49/104

 GET /api/camera/snapshot?width=640&height=480&source=internal

# following command returns a frame which was captured 5 seconds

before the command was executed
GET /api/camera/snapshot?width=640&height=480&source=internal&time=-5

2N TELEKOMUNIKACE a.s., www.2n.cz 50/104

5.21 api display caps
The /api/display/caps function returns a list of device displays including their
properties. Use the function for display detection and resolution.

The function is part of the Display service and the user must be assigned the Display
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format and includes a list of available displays (
displays).

Parameter Description

display Display identifier

resolution Display resolution in pixels

Example:

GET /api/display/caps
{
"success" : true,
"result" : {
"displays" : [
{
"display" : "internal",
"resolution" : {
"width" : 320,
"height" : 240
}
}
]
}
}

5.22.1 Příklady api display image

2N TELEKOMUNIKACE a.s., www.2n.cz 51/104

5.22 api display image
5.22.1 Api Display Image Examples

2N ® IP Verso
2N ® IP Vario
2N ® IP Verso
The /api/display/image function helps you modify the content to be displayed: upload
a GIF / JPEG / BMP image to or delete an earlier uploaded image from the display.

The function is part of the Display service and the user must be assigned the Display
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The PUT or DELETE method can be used for this function: PUT helps upload an image
to the display, DELETE helps delete an uploaded image from the display.

PUT method

Request parameters:

Parameter Description

display Mandatory display identifier. Find the value in Hardware/Extending modules/Module

name or using /api/display/caps.

blob- Mandatory parameter containing a JPEG / BMP / PNG image with 214 x 240 display
image resolution (refer to /api/display/caps). The parameter is applied only if the PUT
method is used. The request may contain just one parameter: blob-image or blob-
video.

blob-video Mandatory parameter containing an MPEG4 / H264 video of the maximum duration
of 60 s, maximum of 15 fps and resolution of 214 x 240 pixels. The request may
contain just one parameter: blob-image or blob-video.

duration Optional parameter. Image display / video playing time. The parameter is set in
milliseconds.

repeat Optional parameter. Video playing repetition count. The parameter applies to video
only.

2N TELEKOMUNIKACE a.s., www.2n.cz 52/104

There are two ways how to display an image: as a notification or overlay. Notifications
are displayed for a predefined period of time and automatically disappear after the
timeout. Overlays keep displayed until replaced with another image or removed by
the user.

If the HTTP request does not include any of the above mentioned parameters, the
overlay mode is used, i.e. the image is displayed for an indefinite period of time. If
both the parameters are included, the display is ended by the event that happens first.

The reply is in the application/json format and includes no parameters.

Image parameters:

Model Image size Supported formats

214 x 240 pixels JPEG (recommended), BMP, PNG

2N ® IP Verso

Note

The supported JPEG format is JPEG Baseline (non-progressive encoding).

Example:

api/display/image?display=ext1&duration=30000
{
"success" : true
}

Video parameters:

Model Video size Supported formats

214 x 240 pixels MPEG4 / H264: Baseline profile, up to 5.2 level

2N ® IP Verso
Example:

api/display/image?display=ext1&repeat=5
{
"success" : true
}

DELETE method

2N TELEKOMUNIKACE a.s., www.2n.cz 53/104

Parameter Description

display Mandatory display identifier. Find the value in Hardware/Extending modules/Module

name or using /api/display/caps.

Example:

DELETE /api/display/image?display=ext1
{
"success" : true
}

2N ® IP Vario
The /api/display/image function helps you modify the content to be displayed: upload
a GIF / JPEG / BMP image to or delete an earlier uploaded image from the display.

Note

The function is available only if the standard display function is disabled

in the Hardware / Display section of the configuration web interface.

The function is part of the Display service and the user must be assigned the Display
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The PUT or DELETE method can be used for this function: PUT helps upload an image
to the display, DELETE helps delete an uploaded image from the display.

Request parameters:

Parameter Description

display Mandatory display identifier (internal).

blob- Mandatory parameter including an image in the supported format with display
image resolution (see /api/display/caps). The parameter is applied only if the PUT method
is used.

The reply is in the application/json format and includes no parameters.

Image parameters:

2N TELEKOMUNIKACE a.s., www.2n.cz 54/104

 Model Image size Supported formats

320 x 240 pixels JPEG (recommended), GIF, BMP

2N ® IP Vario

Upozornění

The supported JPEG format is JPEG Baseline (non-progressive encoding).

Example:

DELETE /api/display/image?display=internal
{
"success" : true
}

5.22.1 Api Display Image Examples

The below-mentioned examples help sending data from the control application to the

2N ® IP Verso and 2N® IP Vario displays.

An image can be displayed either as a notification or overlay. 2N ® IP Verso can display
images in either way, 2N ® IP Vario can only display notifications. Notifications are
displayed for a pre-defined time and disappear automatically after this timeout.
Overlays keep displayed until replaced with another image or removed by the user.

The * duration * parameter gives the image/video display time in ms.

The *repeat* parameter specifies the count of video repetitions and is ignored for
images.

If the HTTP request does not include any of the above-mentioned parameters, the
overlay mode is used, i.e. the image is displayed for an indefinite period of time. If
both the parameters are included, the display is terminated by the event that happens
first.

2N TELEKOMUNIKACE a.s., www.2n.cz 55/104

Image Loading to 2N ® IP Verso/2N ® IP Vario Display

Note

Each model supports a different image resolution.

Model Image size Supported formats

214 x 240 pixels JPEG (recommended), BMP, PNG

2N ® IP Verso
320 x 240 pixels JPEG (recommended), GIF, BMP
2N ® IP Vario

Request URL: https://10.27.24.15/api/display/image?display=ext1

Request method: PUT

Remote address: 10.27.24.15:443
Status code: 200 OK
Version: HTTP/1.1

Response headers (95 B)

Server: HIP2.22.0.31.1
Content-Type: application/json
Content-Length: 24

Request headers (494 B)

Host: 10.27.24.15
User-Agent: Mozilla/5.0 (Windows NT 6.1; W…) Gecko/20100101 Firefox/56.0
Accept: */*
Accept-Language: cs,en-US;q=0.7,en;q=0.3
Accept-Encoding: gzip, deflate, br
Referer: https://10.27.24.15/apitest.html
Content-Length: 1325
Content-Type: multipart/form-data; boundary=…--------------258852674219952
Cookie: _ga=GA1.1.375392382.1496656977…id=GA1.1.638680516.1507547865
Connection: keep-alive

Query string

2N TELEKOMUNIKACE a.s., www.2n.cz 56/104

 display: ext1

Request payload

-----------------------------258852674219952

Content-Disposition: form-data; name="blob-image"; filename="picture.png"

Content-Type: image/png

‰PNG
IHDR Ö ót
R sRGB ®Îé gAMA ±üa pHYs Ço¨d üIDATx^íq8@Ô•‚\Oq3)»Ž4Y‚$'Ô
¬ÎÔ\ƒ}@J‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL
‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$H: }ííýáIžy/@‚IP
‚±×L‘ ±Ó\–^b; ŽkëÓ©í-f)ËýBÎLç÷m.jb¶v?˜m|;éJBÎK0‹›a÷/›dY¸Z$Á9+Áá[CC/´)
é68[\quŽN%Á©oÂöu6—×mcš%x!§Žl¶°¦I¸Ë5céw¬“`© •}š%¸Íi7še`»Î"Á9;ÁáÚ˜%
¸ÍbwúHI_^“—q|7Ëí—‹:+Á Áög±; ?8)Áâ‹ ÝfK_'Á÷x9FÇYL¦Ó«ÝÇ÷â©žâ|Z?ž—lââ
(\M†KJBÎú-848µ|x~-Á=r«ƒ%•·÷d±ÇY<>Ý‘x|5ž?-¸öWR‰fâ#ß”`ÜJ‚’ î4^1Áá]Y‚µ—
JpšO
R‚;ú!{WokxÉ×®D‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL
‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL
‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL
‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL
‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL
‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL‚Ä$HL
‚Ä$HL‚¤>>+uKé<:– IEND®B`‚

-----------------------------258852674219952--

Video Loading to 2N ® IP Verso Display

Poznámka

Model Video size Supported formats

214 x 240 pixels MPEG4 / H264: Baseline profile, level up to 5.2

2N ® IP Verso

Request URL: https://10.27.24.15/api/display/image?

display=ext1&duration=20&repeat=3

Request method: PUT

Remote address: 10.27.24.15:443

2N TELEKOMUNIKACE a.s., www.2n.cz 57/104
 Remote address: 10.27.24.15:443
Status code: 200 OK
Version: HTTP/1.1

Response headers (95 B)

Server: HIP2.22.0.31.1
Content-Type: application/json
Content-Length: 24

Request headers (516 B)

Host: 10.27.24.15
User-Agent: Mozilla/5.0 (Windows NT 6.1; W…) Gecko/20100101 Firefox/56.0
Accept: */*
Accept-Language: cs,en-US;q=0.7,en;q=0.3
Accept-Encoding: gzip, deflate, br
Referer: https://10.27.24.15/apitest.html
Content-Length: 943815
Content-Type: multipart/form-data; boundary=---------------------------
14948718218673
Cookie: _ga=GA1.1.375392382.1496656977…id=GA1.1.638680516.1507547865
Connection: keep-alive

Query string

display – ext1
duration – 20
repeat – 3

Request payload

-----------------------------14948718218673

2N TELEKOMUNIKACE a.s., www.2n.cz 58/104

Content-Disposition: form-data; name="blob-video"; filename="2N_intro.mp4"

Content-Type: video/mp4

ftypmp42 isomiso2avc1mp41 free O!mdat ·ÜEéH·–, #îx264 - core 148

r2708 86b7198 - H.264/MPEG-4 AVC codec - Copyleft 2003-2016 - http://www
.videolan.org/x264.html - options: cabac=0 ref=2 deblock=0:0:0
analyse=0x1:0x111 me=hex subme=6 psy=1 psy_rd=1.00:0.00 mixed_ref=1
me_range=16 chroma_me=1 trellis=1 8x8dct=0 cqm=0 deadzone=21,11
fast_pskip=1 chroma_qp_offset=-2 threads=6 lookahead_threads=1
sliced_threads=0 nr=0 decimate=1 interlaced=0 bluray_compat=0
constrained_intra=0 bframes=0 weightp=0 keyint=150 keyint_min=15
scenecut=40 intra_refresh=0 rc_lookahead=30 rc=crf mbtree=1 crf=22.0
qcomp=0.60 qpmin=0 qpmax=69 qpstep=4 vbv_maxrate=20000
vbv_bufsize=25000 crf_max=0.0 nal_hrd=none filler=0 ip_ratio=1.40 aq=1:
1.00 € eˆ„ ®C‡Ü!q@ CzNbyRÔ~ˆ$]´í·Fb0~hM=>?„´mßâµWj«¸z”ÄO”#Ü~éÂ6Ë-Ó
üP•?n?馞š{–ü7-«“b»ž¶˜G
LZ.˜üßÓý×\’žjo¸…zxk&+ýGkü¸3 ˆ|p«^¸UzÖXÉž¤€p!>lÍMfÓo_„0„)Îl‚Ë?_?|{>Îl&
/Í÷~»T<vW
/} e‡•¶ßy9šziý-$‰_Á+{]]u×]wÜ"ý9§ü$l7zë®ë®ë®úë®ë®ë®ë®ë®ë®ë®xxCî‰
®ë®ë®:OäyŽŠ{Osó«‘u]u×S·,\7·p°Ó–X ]`§ÄƒÜš§/ó Gi...

-----------------------------14948718218673--

Query string  

· display · ext1

· duration · 20

· repeat ·3

2N TELEKOMUNIKACE a.s., www.2n.cz 59/104

5.23 api log caps
The /api/log/caps function returns a list of supported event types that are recorded in
the device. This list is a subset of the full event type list below:

Event type Description Note

DeviceState Signals a system event generated at  

device state changes.

AudioLoopTest Signals performance and result of an with a valid Enhanced

automatic audio loop test. Audio licence key only

MotionDetected Signals motion detection via a camera. for camera-equipped

models only

NoiseDetected Signals increased noise level detection. for microphone

/microphone input
equipped models only

KeyPressed Signals pressing of a speed dial  

/numeric keypad button.

KeyReleased Signals releasing of a speed dial  

/numeric keypad button.

CodeEntered Signals entering of a user code via the for numeric keypad
numeric keypad. equipped models only

CardEntered Signals tapping of an RFID card on the for RFID card reader
card reader. equipped models only

InputChanged Signals a logic input state change.  

OutputChanged Signals a logic output state change.  

SwitchStateChanged Signals a switch 1–4 state change.  

CallStateChanged Signals a setup/end/change of the  

active call state.

2N TELEKOMUNIKACE a.s., www.2n.cz 60/104

Event type Description Note

RegistrationStateChanged Signals a SIP server registration state  

change.

TamperSwitchActivated Signals tamper switch activation. for tamper switch

equipped models only

UnauthorizedDoorOpen Signals unauthorised door opening. for digital input equipped

models only

DoorOpenTooLong Signals excessively long door opening, for digital input equipped
or door closing failure within the models only
timeout.

LoginBlocked Signals temporary blocking of login to  

the web interface.

UserAuthenticated Signals user authentication and  

subsequent door opening.

CardHeld Signals RFID card tapping and holding  

for more than 4 s.

SilentAlarm Signals silent alarm activation.  

ApLockStateChange Signals a lock state change.  

RexActivated Signals REX departure button  

activation.

AccessLimited Signals user rejection.  

PairingStateChanged Signals pairing with a Bluetooth  

interface.

SwitchesBlocked Signals lock blocking by tamper switch  

activation.

FingerEntered Signals that a finger has been swiped  

across the biometric reader.

2N TELEKOMUNIKACE a.s., www.2n.cz 61/104

Event type Description Note

MobKeyEntered Signals Bluetooth reader  

authentication.

DoorStateChanged Signals a door state change.  

UserRejected Signals user authentication rejection.  

DisplayTouched Signals display touch.

for 2N ® IP Verso and 2N®
Access Unit models only

The function is part of the Logging service and requires no special user privileges.

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format:

Parameter Type Description

events array Array of strings including a list of supported event types

2N TELEKOMUNIKACE a.s., www.2n.cz 62/104

Example:

GET /api/log/caps
{
"success" : true,
"result" : {
"events" : [
"KeyPressed",
"KeyReleased",
"InputChanged",
"OutputChanged",
"CardEntered",
"CallStateChanged",
"AudioLoopTest",
"CodeEntered",
"DeviceState",
"RegistrationStateChanged"
]
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 63/104

5.24 api log subscribe
The /api/log/subscribe function helps you create a subscription channel and returns a
unique identifier to be used for subsequent dialling of the /api/log/pull or /api/log
/unsubscribe function.

Each subscription channel contains an event queue of its own. All the new events that
match the channel filter (filter parameter) are added to the channel queue and read
using the /api/log/pull function.

At the same time, the device keeps the event history queue (last 10000 events) in its
internal memory. The event history queue is empty by default.

Use the include parameter to specify whether the channel queue shall be empty after
restart (storing of events occurring after the channel is opened), or be filled with all or
some events from the event history records.

Use the duration parameter to define the channel duration if it is not accessed via /api
/log/pull. The channel will be closed automatically when the defined timeout passes as
if the /api/log/unsubscribe function were used.

The function is part of the Logging service and requires some user privileges for
authentication. Unprivileged user events shall not be included in the channel queue.

Event type Required user privileges

DeviceState None

AudioLoopTest None

MotionDetected None

NoiseDetected None

KeyPressed Keypad monitoring

KeyReleased Keypad monitoring

CodeEntered Keypad monitoring

CardEntered UID monitoring (cards/Wiegand)

InputChanged I/O monitoring

2N TELEKOMUNIKACE a.s., www.2n.cz 64/104

Event type Required user privileges

OutputChanged I/O monitoring

SwitchStateChanged I/O monitoring

CallStateChanged Call/phone monitoring

RegistrationStateChanged Call/phone monitoring

TamperSwitchActivated None

UnauthorizedDoorOpen None

DoorOpenTooLong None

LoginBlocked None

UserAuthenticated None

CardHeld None

SilentAlarm None

ApLockStateChange None

RexActivated None

AccessLimited None

PairingStateChange None

SwitchesBlocked None

FingerEntered None

MobKeyEntered None

DoorStateChanged None

2N TELEKOMUNIKACE a.s., www.2n.cz 65/104

Event type Required user privileges

UserRejected None

DisplayTouched None

2N TELEKOMUNIKACE a.s., www.2n.cz 66/104

The GET or POST method can be used for this function.

Request parameters:

Parameter Type Mandatory Default Description

value

include string No new Define the events to be added to the channel event
queue:

new - only new events occurring after channel

creation

all - all events recorded so far including those

occurring after channel creation

-t - all events recorded in the last t seconds

including those occurring after channel creation
(-10, e.g.)

filter list No no List of required event types separated with commas.

filter The parameter is optional and if no value is entered,
all available event types are transferred via the
channel.

duration uint32 No 90 Define a timeout in seconds after which the channel

shall be closed automatically if no /api/log/pull
reading operations are in progress. Every channel
reading automatically extends the channel duration
by the value included here. The maximum value is
3600 s.

The reply is in the application/json format and includes an identifier created by

subscription.

Parameter Type Description

id uint32 Unique identifier created by subscription

2N TELEKOMUNIKACE a.s., www.2n.cz 67/104

Example:

GET /api/log/subscribe?filter=KeyPressed,InputChanged
{
"success" : true,
"result" : {
"id" : 2121013117
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 68/104

5.25 api log unsubscribe
The /api/log/unsubscribe function helps you close the subscription channel with the
given identifier. When the function has been executed, the given identifier cannot be
used, i.e. all subsequent /api/log/pull or /api/log/unsubscribe calls with the same
identifier will end up with an error.

The function is part of the Logging service and requires no special user privileges.

The GET or POST method can be used for this function.

Request parameters:

Parameter Type Mandatory Default Description

value

id uint32 Yes – Identifier of the existing channel obtained by

preceding dialling of /api/log/subscribe

The reply is in the application/json format and includes no parameters.

Example:

GET /api/log/unsubscribe?id=21458715
{
"success" : true,
}

2N TELEKOMUNIKACE a.s., www.2n.cz 69/104

5.26 api log pull
The /api/log/pull function helps you read items from the channel queue (subscription)
and returns a list of events unread so far or an empty list if no new event is available.
Larger amounts of events are pulled in batches of 128 events.

Use the timeout parameter to define the maximum time for the intercom to generate
the reply. If there is one item at least in the queue, the reply is generated immediately.
In case the channel queue is empty, the intercom puts off the reply until a new event
arises or the defined timeout elapses.

The function is part of the Logging service and requires no special user privileges.

The GET or POST method can be used for this function.

Request parameters:

Parameter Type Mandatory Default Description

value

id uint32 Yes – Identifier of the existing channel created by

preceding dialling of /api/log/subscribe

timeout uint32 No 0 Define the reply delay (in seconds) if the channel
queue is empty. The default value 0 means that the
intercom shall reply without delay.

The reply is in the application/json format and includes a list of events.

Parameter Type Description

events array Event object array. If no event occurs during the timeout, the array is empty.

2N TELEKOMUNIKACE a.s., www.2n.cz 70/104

Example:

GET /api/log/pull
{

"success" : true,
"result" : {
"events" : [
{
"id" : 1,
"tzShift" : 0,
"utcTime" : 1437987102,
"upTime" : 8,
"event" : "DeviceState",
"params" : {
"state" : "startup"
}
},
{
"id" : 3,
"tzShift" : 0,
"utcTime" : 1437987105,
"upTime" : 11,
"event" : "RegistrationStateChanged",
"params" : {
"sipAccount" : 1,
"state" : "registered"
}
}
]
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 71/104

Events
Each event in the events field includes the following common information:

Parameter Type Description

id uint32 Internal event record ID (32bit number, 1 after intercom restart

incremented with every new event)

utcTime uint32 Absolute event rise time (Unix Time, UTC)

upTime uint32 Relative event rise time (seconds after intercom restart)

tzShift int32 Difference between the local time and Coordinated Universal Time (UTC) in
minutes.

Add this value to utcTime to obtain the local time of event generation
according to the device time zone:

localTime = utcTime + tzShift * 60

event string Event type (KeyPressed, InputChanged, ...)

params object Specific event parameters

2N TELEKOMUNIKACE a.s., www.2n.cz 72/104

DeviceState
Signals the device state changes.

Event parameters:

Parameter Type Description

state string Signalled device state:

startup – generated one-time after device start (always the first event ever)

Example:

{
"id" : 1,
"tzShift" : 0,
"utcTime" : 1437987102,
"upTime" : 8,
"event" : "DeviceState",
"params" : {
"state" : "startup"
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 73/104

AudioLoopTest
Signals performance and result of an automatic audio loop test. The AudioLoopTest
event is only available in selected models with a valid Enhanced Audio licence. The
event is signalled whenever the automatic test has been performed (either scheduled
or manually started).

Parameter Type Description

result string Result of an accomplished text:

passed – the test was carried out successfully, no problem has been
detected.

failed – the test was carried out, a loudspeaker/microphone problem has

been detected.

Example:

{
"id" : 26,
"tzShift" : 0,
"utcTime" : 1438073190,
"upTime" : 9724,
"event" : "AudioLoopTest",
"params" : {
"result" : "passed"
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 74/104

MotionDetected
Signals motion detection via a camera. The event is available in camera-equipped
models only. The event is generated only if the function is enabled in the intercom
camera configuration.

Event parameters:

Parameter Type Description

state string Motion detector state:

in – signals the beginning of the interval in which motion was detected.

out – signals the end of the interval in which motion was detected.

Example:

{
"id" : 2,
"tzShift" : 0,
"utcTime" : 1441357589,
"upTime" : 1,
"event" : "MotionDetected",
"params" : {
"state" : "in"
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 75/104

NoiseDetected
Signals an increased noise level detected via an integrated or external microphone.
The event is generated only if this function is enabled in the intercom configuration.

Event parameters:

Parameter Type Description

state string Noise detector state:

in – signals the beginning of the interval in which noise was detected.

out – signals the end of the interval in which noise was detected.

Example:

{
"id" : 2,
"tzShift" : 0,
"utcTime" : 1441357589,
"upTime" : 1,
"event" : "NoiseDetected",
"params" : {
"state" : "in"
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 76/104

KeyPressed and KeyReleased
Signals pressing (KeyPressed) or releasing (KeyReleased) of speed dial or numeric
keypad buttons.

Event parameters:

Parameter Type Description

key string Pressed/released button code:

0 to 9 – numeric keypad buttons

%1–%150 – speed dialling buttons

* – button with a * or phone symbol

# – button with a # or key symbol

Example:

{
"id" : 4,
"tzShift" : 0,
"utcTime" : 1437987888,
"upTime" : 794,
"event" : "KeyPressed",
"params" : {
"key" : "5"
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 77/104

CodeEntered
Signals entering of a user code via the numeric keypad. The event is generated in
numeric keypad equipped devices only.

Event parameters:

Parameter Type Description

code string User code, 1234, e.g. The code includes 2 digits at least and 00 cannot be
used.

valid boolean Code validity (i.e. if the code is defined as a valid user code or universal
switch code in the intercom configuration):

false – invalid code

true – valid code

Example:

{
"id" : 23,
"tzShift" : 0,
"utcTime" : 1438072978,
"upTime" : 9512,
"event" : "CodeEntered",
"params" : {
"code" : "5864",
"valid" : false
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 78/104

CardEntered
Signals tapping an RFID card on the card reader. The event is generated in RFID card
reader equipped devices only.

Event parameters:

Parameter Type Description

direction string RFID direction:

in – arrival

out – departure

any – passage

Note: Set the card reader direction using the intercom configuration
interface.

reader string RFID card reader/Wiegand module name, or one of the following non-
modular intercom model values:

internal – internal card reader (2N IP intercoms)

external – external card reader connected via the Wiegand interface

Note: Set the card reader name using the intercom configuration interface
.

uid string Unique identifier of the applied card (hexadecimal format, 6 - 16

characters depending on the card type)

valid boolean Validity of the applied RFID card (if the card uid is assigned to one of the
intercom users listed in the phonebook)

false – invalid card

true – valid card

2N TELEKOMUNIKACE a.s., www.2n.cz 79/104

Example:

{
"id" : 26,
"tzShift" : 0,
"utcTime" : 1438072979,
"upTime" : 9513,
"event" : "CardEntered",
"params" : {
"direction" : "any",
"reader" : "ext7",
"uid" : "01045E31BB",
"valid" : false
}
}

InputChanged and OutputChanged

Signals a state change of the logic input (InputChanged) or output (OutputChanged).
Use the /api/io/caps function to get the list of available inputs and outputs.

Event parameters:

Parameter Type Description

port string I/O port name

state boolean Current I/O port logic state:

false – inactive, log. 0

true – active, log. 1

Example:

{
"id" : 2,
"tzShift" : 0,
"utcTime" : 1437987103,
"upTime" : 9,
"event" : "OutputChanged",
"params" : {
"port" : "led_secured",
"state" : false
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 80/104

SwitchStateChanged
Signals a switch state change (refer to the intercom configuration in Hardware |
Switches).

Event parameters:

Parameter Type Description

switch uint32 Switch number 1...4

state boolean Current logic state of the switch:

false – inactive, log.0

true – active, log.1

Example:

{
"id" : 2,
"tzShift" : 0,
"utcTime" : 1437987103,
"upTime" : 9,
"event" : "SwitchStateChanged",
"params" : {
"switch" : 1,
"state" : true
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 81/104

CallStateChanged
Signals a setup/end/change of the active call state.

Event parameters:

Parameter Type Description

direction string Call direction:

incoming – incoming call

outgoing – outgoing call

state string Current call state:

connecting – call setup in progress (outgoing calls only)

ringing – ringing

connected – call connected

terminated – call terminated

peer string SIP URI of the calling (incoming calls) or called (outgoing calls) subscriber

reason string Call end reason. The parameter is available only if the call end state is
signalled.

normal – normal call end

busy – called station busy

rejected – call rejected

noanswer – no answer from called user

noresponse – no response from called station (to SIP messages)

completed_elsewhere – call answered by another station (group calls)

failure – call setup failure

session uint32 Unique call identifier. Can also be used in the /api/call/answer, /api/call
/hangup and /api/call/status functions.

call uint32 TBD

2N TELEKOMUNIKACE a.s., www.2n.cz 82/104

Example:

{
"id" : 5,
"tzShift" : 0,
"utcTime" : 1438064126,
"upTime" : 660,
"event" : "CallStateChanged",
"params" : {
"direction" : "incoming",
"state" : "ringing",
"peer" : "sip:[email protected]:5062;user=phone",
"session" : 1,
"call" : 1
}
}

RegistrationStateChanged
Signals a change of the SIP account registration state.

Event parameters:

Parameter Type Description

sipAccount uint32 SIP account number showing a state change:

1 – SIP account 1

2 – SIP account 2

state string New SIP account registration state:

registered – account successfully registered

unregistered – account unregistered

registering – registration in progress

unregistering – unregistration in progress

2N TELEKOMUNIKACE a.s., www.2n.cz 83/104

Example:

{
"id" : 3,
"tzShift" : 0,
"utcTime" : 1437987105,
"upTime" : 11,
"event" : "RegistrationStateChanged",
"params" : {
"sipAccount" : 1,
"state" : "registered"
}
}

TamperSwitchActivated
Signals tamper switch activation - device cover opening. Make sure that the tamper
switch function is configured in the Digital Inputs | Tamper Switch menu.

Event parameters:

Parameter Type Description

state string Tamper switch state:

in – signals tamper switch activation (i.e. device cover open).

out – signals tamper switch deactivation (device cover closed).

Example:

{
"id" : 54,
"tzShift" : 0,
"utcTime" : 1441357589,
"upTime" : 158,
"event" : "TamperSwitchActivated",
"params" : {
"state" : "in"
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 84/104

UnauthorizedDoorOpen
Signals unauthorised door opening. Make sure that a door-open switch is connected
to one of the digital inputs and the function is configured in the Digital Inputs | Door
State menu.

Event parameters:

Parameter Type Description

state string Unauthorised door opening state:

in – signals the beginning of the unauthorised opening state.

out – signals the end of the unauthorised door opening state.

Example:

{
"id" : 80,
"tzShift" : 0,
"utcTime" : 1441367842,
"upTime" : 231,
"event" : "UnauthorizedDoorOpen",
"params" : {
"state" : "in"
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 85/104

DoorOpenTooLong
Signals an excessively long door opening or failure to close the door within a timeout.
Make sure that a door-open switch is connected to one of the digital inputs and the
function is configured in the Digital Inputs | Door State menu.

Event parameters:

Parameter Type Description

state string DoorOpenToo Long state:

in – signals the beginning of the DoorOpenTooLong state.

out – signals the end of the DoorOpenTooLong state.

Example:

{
"id" : 96,
"tzShift" : 0,
"utcTime" : 1441369745,
"upTime" : 275,
"event" : "DoorOpenTooLong",
"params" : {
"state" : "out"
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 86/104

LoginBlocked
Signals a temporary blocking of the web interface access due to repeated entering of
an invalid login name or password.

Event parameters:

Parameter Type Description

address string IP address from which invalid data were entered repeatedly.

Example:

{
"id" : 5,
"tzShift" : 0,
"utcTime" : 1441369745,
"upTime" : 275,
"event" : "LoginBlocked",
"params" : {
"address" : "10.0.23.32"
}
}

UserAuthenticated
Signals user authentication and subsequent door opening.

Event parameters:

Parameter Type Description

name string Specifies the name of the phone book user.

index string Specifies the index of the phone book user; the range is <0 - 1998>.

uuid string
®
User uuid, used for devices connected to 2N Access Commander only. Any

®
device disconnected from 2N Access Commander does not send this

parameter.

2N TELEKOMUNIKACE a.s., www.2n.cz 87/104

Example:

{
"id" : 25125,
"tzShift" : 60,
"utcTime" : 1478096164,
"upTime" : 696118,
"event" : "UserAuthenticated",
"params" : {
"name" : "Pils Jiri",
"index" : 51,
"uuid" : "3ffe32a1-7e8b-9697-67db-5637566ec279"
}
}

CardHeld
Signals that an RFID card has been tapped on the reader for more than 4 s.

Event parameters:

Parameter Type Description

ap string

session string Informs how many times the card has been applied.

direction string in, out

reader string  

uid string User uid for devices connected to the Access Commander only. Devices
disconnected from the Access Commander do not send this parameter.

valid string true, false

2N TELEKOMUNIKACE a.s., www.2n.cz 88/104

Example:

{
"id" : 9,
"tzShift" : 0,
"utcTime" : 1516893493,
"upTime" : 354,
"event" : "CardHeld",
"params" : {
"ap" : 1,
"session" : 4,
"direction" : "out",
"reader" : "ext2",
"uid" : "3F00F318E7",
"valid" : true
}
}

SilentAlarm
Signals silent alarm activation.

Event parameters:

Parameter Type Description

ap string

session string Informs how many silent alarms have been activated.

name string Specifies the phonebook username.

2N TELEKOMUNIKACE a.s., www.2n.cz 89/104

Example:

{
"id" : 165,
"tzShift" : 0,
"utcTime" : 1516894039,
"upTime" : 900,
"event" : "SilentAlarm",
"params" : {
"ap" : 0,
"session" : 11,
"name" : "Thomas"
}
}

AccessLimited
Signals rejection of the set user.

Event parameters:

Parameter Type Description

ap string  

type string card

state string  

Example:

{
"id" : 408,
"tzShift" : 0,
"utcTime" : 1517302112,
"upTime" : 408951,
"event" : "AccessLimited",
"params" : {
"ap" : 0,
"type" : "card",
"state" : "in"
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 90/104

PairingStateChange
Signals pairing with a Bluetooth interface.

Event parameters:

Parameter Type Description

state string pending

authId string  

Example:

{
"id" : 197,
"tzShift" : 0,
"utcTime" : 1516894499,
"upTime" : 1360,
"event" : "PairingStateChanged",
"params" : {
"state" : "pending",
"authId" : "F2CAE955C9B4E81CD00E3A096E52543B"
}
}

UserAuthenticated
Signals successful user authentication.

Event parameters:

Parameter Type Description

ap string  

session string Informs how many user authentications have been made.

name string  

index string  

2N TELEKOMUNIKACE a.s., www.2n.cz 91/104

Example:

{
"id" : 370,
"tzShift" : 0,
"utcTime" : 1517301699,
"upTime" : 408538,
"event" : "UserAuthenticated",
"params" : {
"ap" : 0,
"session" : 23,
"name" : "Thomas",
"index" : 0
}
}

SwitchesBlocked
Signals lock blocking by the tamper switch.

Event parameters:

Parameter Type Description

state string in, out

Example:

{
"id" : 205,
"tzShift" : 0, "utcTime" : 1516894667,
"upTime" : 1528,
"event" : "SwitchesBlocked",
"params" : {
"state" : "in"
}
}

FingerEntered
Signals that a finger has been tapped on the biometric reader.

Event parameters:

2N TELEKOMUNIKACE a.s., www.2n.cz 92/104

Parameter Type Description

valid string true, false

Example: Reading of a user's fingerprint

{
"id" : 2,
"tzShift" : 0,
"utcTime" : 1511794372,
"upTime" : 748,
"event" : "FingerEntered",
"params" : {
"session" : 1,
"valid" : true
}
}

Unsuccessful specification: Reading of an unset user's fingerprint

{
"id" : 14,
"tzShift" : 0,
"utcTime" : 1511859513,
"upTime" : 65887,
"event" : "FingerEntered",
"params" : {
"session" : 3,
"valid" : false
}
}

MobKeyEntered
Signals Bluetooth reader authentication.

Event parameters:

Parameter Type Description

ap string  

session string  

2N TELEKOMUNIKACE a.s., www.2n.cz 93/104

direction string in, out

authid string  

valid string true, false

Example:

{
"id" : 208,
"tzShift" : 0,
"utcTime" : 1516894808,
"upTime" : 1669,
"event" : "MobKeyEntered",
"params" : {
"ap" : 1,
"session" : 7,
"direction" : "out",
"authid" : "E64C143F419199D47BCE0B689F298EEB",
"valid" : true
}
}

DoorStateChanged
Signals a door state change.

Event parameters:

Parameter Type Description

state string opened, closed

2N TELEKOMUNIKACE a.s., www.2n.cz 94/104

Example:

{
"id" : 240,
"tzShift" : 0,
"utcTime" : 1516895295,
"upTime" : 2156,
"event" : "DoorStateChanged",
"params" : {
"state" : "opened"
}
}

UserRejected
Signals user authentication rejection.

Event parameters:

Parameter Type Description

ap string  

session string  

name string  

uuid string  

reason string apLocked, invalidTime, invalidProfile, invalidSequence, invalidCredential,

authInterupted, timeout, switchDisabled

2N TELEKOMUNIKACE a.s., www.2n.cz 95/104

Example:

{
"id" : 201,
"tzShift" : 0,
"utcTime" : 1516894605,
"upTime" : 1466,
"event" : "UserRejected",
"params" : {
"ap" : 1,
"session" : 6,
"name" : "Thomas",
"reason" : "timeout"
}
}

DisplayTouched
Signals display touch.

Event parameters:

Parameter Type Description

x string Display touch point coordinate. The maximum value depends of the display
resolution.

y string Display touch point coordinate.

dx string Coordinate change due to movement on the display; negative values are
possible. The maximum value depends of the display resolution.

dy string Coordinate change due to movement on the display.

2N TELEKOMUNIKACE a.s., www.2n.cz 96/104

Example:

{
"id" : 337,
"tzShift" : 0,
"utcTime" : 1517301424,
"upTime" : 408263,
"event" : "DisplayTouched",
"params" : {
"x" : 89,
"y" : 100,
"dx" : 0,
"dy" : 0
}
}

2N TELEKOMUNIKACE a.s., www.2n.cz 97/104

5.27 api audio test
The /api/audio/test function launches an automatic test of the intecom built-in
microphone and speaker. The test result is logged as an AudioLoopTest event.

The function is part of the Audio service and the user must be assigned the Audio
Control privilege for authetication if required. The function is only available with the
Enhanced Integration and Enhanced Audio licence key.

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format and includes no parameters.

Example:

GET /api/audio/test
{
"success" : true
}

2N TELEKOMUNIKACE a.s., www.2n.cz 98/104

5.28 api email send
The /api/email/send function sends an e-mail to the required address. Make sure that
the SMTP service is configured correctly for the device (i.e. correct SMTP server
address, login data etc.).

The function is part of the Email service and the user must be assigned the Email
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only.

The GET or POST method can be used for this function.

Request parameters:

Parameter Description

to Mandatory parameter specifying the delivery address.

subject Mandatory parameter specifying the subject of the message.

body Optional parameter specifying the contents of the message (including html marks
if necessary). If not completed, the message will be delivered without any
contents.

pictureCount Optional parameter specifying the count of camera images to be enclosed. If not
completed, no images are enclosed. Parameter values: [0, 5].

timeSpan Optional parameter specifying the timespan in seconds of the snapshots enclosed
to the email. Default value: 0.

width Optional parameters specifying the resolution of camera images to be enclosed.

The image height and width must comply with one of the supported options (see
height api/camera/caps).

2N TELEKOMUNIKACE a.s., www.2n.cz 99/104

The reply is in the application/json format and includes no parameters.

Example:

GET /api/email/[email protected]&subject=Hello&body=Hello
{
"success" : true
}

2N TELEKOMUNIKACE a.s., www.2n.cz 100/104

5.29 api pcap
The /api/pcap function helps download the network interface traffic records (pcap
file). You can also use the /api/pcap/restart a /api/pcap/stop functions for network
traffic control.

The function is part of the System service and the user must be assigned the System
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format and the downloaded file can be opened
directly in Wireshark, for example.

Example:

GET /api/pcap

2N TELEKOMUNIKACE a.s., www.2n.cz 101/104

5.30 api pcap restart
The /api/pcap/restart function deletes all records and restarts the network interface
traffic recording.

The function is part of the System service and the user must be assigned the System
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format and includes no parameters.

Example:

GET /api/pcap/restart
{
"success" : true
}

2N TELEKOMUNIKACE a.s., www.2n.cz 102/104

5.31 api pcap stop
The /api/pcap/stop function stops the network interface traffic recording.

The function is part of the System service and the user must be assigned the System
Control privilege for authentication if required. The function is available with the
Enhanced Integration licence key only

The GET or POST method can be used for this function.

The function has no parameters.

The reply is in the application/json format and includes no parameters.

Example:

GET /api/pcap/restart
{
"success" : true
}

2N TELEKOMUNIKACE a.s., www.2n.cz 103/104

 2N TELEKOMUNIKACE a.s.

Modřanská 621, 143 01 Prague 4, Czech Republic

Phone: +420 261 301 500, Fax: +420 261 301 599

E-mail: [email protected]

Web: www.2n.cz

v2.23

2N TELEKOMUNIKACE a.s., www.2n.cz 104/104