Summary of Helios IP

  • Page 1

    Www.2n.Cz version firmware 2n ® helios ip http api ip intercom configuration manual 2.8 2.8.

  • Page 2: Content

    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 c...

  • Page 3: Content

    Content 1. Terms and symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2. Http api general description . . . . . . . . . . . . . . . . . . . . . . . 5 3. Event logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 4. Http api message list . . . ....

  • Page 4: 1. Terms and Symbols

    4 2n telekomunikace a.S., www.2n.Cz ® 1. Terms and symbols the following symbols and pictograms are used in the manual: safety abide by this information to prevent persons from injury. Always warning abide by this information to prevent damage to the device. Always caution important information for ...

  • Page 5: 2. Http Api General

    5 2n telekomunikace a.S., www.2n.Cz ® 2. Http api general description 2n helios ip ® http api (application programming interface) is an interface designed for remote control, configuration and data retrieval via third party 2n helios ip ® applications. Api enables 2n intercoms to be integrated in ex...

  • Page 6

    6 2n telekomunikace a.S., www.2n.Cz ® post /… http/1.1 host: … content-type: application/soap+xml content-length: … additional control information of request request parameters if the request is processed successfully, sends the following http 2n helios ip ® response: http/1.1 200 ok content-type: a...

  • Page 7

    7 2n telekomunikace a.S., www.2n.Cz ® http/1.1 400 bad request content-length: … content-type: application/soap+xml xmlns:s="http://www.W3.Org/2003/05/soap-envelope" xmlns:ter="http://www.Onvif.Org/ver10/error"> error code error subcode error cause details additional error details xmlns:s="http://ww...

  • Page 8: 3. Event Logging

    8 2n telekomunikace a.S., www.2n.Cz ® 3. Event logging 2n helios ip ® implements an internal event log, which records events arising in the device – such as keypressed, codeentered, cardentered, callstatechanged and so on. The log capacity is 500 events. When the log fills up, any new event deletes ...

  • Page 9

    9 2n telekomunikace a.S., www.2n.Cz ® in the mode, sends events to the subscriber in the form subscription 2n helios ip ® of notify messages. In the mode, the client sends the getmessages request to retrieve the log pullpoint data. Data retrieval in subscription mode to retrieve events from in the s...

  • Page 10

    10 2n telekomunikace a.S., www.2n.Cz ® data retrieval in pullpoint mode to retrieve events from in the pullpoint mode, create the pullpoint via 2n helios ip ® the request, specifying the type of events to be retrieved and the createpullpoint subscription time. If the subscription is successful, send...

  • Page 11

    11 2n telekomunikace a.S., www.2n.Cz ®.

  • Page 12: 4. Http Api Message List

    12 2n telekomunikace a.S., www.2n.Cz ® 4. Http api message list 2n helios http api ® defines the following types of messages: subscribe subscriberesponse createpullpoint createpullpointresponse renew renewresponse unsubscribe unsubscriberesponse getmessages getmessagesresponse notify see below for d...

  • Page 13: Message Parameters

    13 2n telekomunikace a.S., www.2n.Cz ® xmlns:wsnt="http://docs.Oasis-open.Org/wsn/b-2" xmlns:a="http://www.W3.Org/2005/08/addressing" xmlns:event2n="http://www.2n.Cz/2013/event"> {http_consumer_address} "http://www.2n.Cz/2013/topicexpression/multiple"> {events_list} {datetime_or_duration} {max_numbe...

  • Page 14: Subscriberesponse

    14 2n telekomunikace a.S., www.2n.Cz ® datetime_or_duration set the subscription time. Subscription will be cancelled automatically by when this time period expires. Send the renew request before expiry to extend the subscription time. Enter the absolute time (datetime) or relative duration (duratio...

  • Page 15: Message Parameters

    15 2n telekomunikace a.S., www.2n.Cz ® xmlns:s="http://www.W3.Org/2003/05/soap-envelope" xmlns:wsa5="http://www.W3.Org/2005/08/addressing" xmlns:wsnt="http://docs.Oasis-open.Org/wsn/b-2" xmlns:event2n="http://www.2n.Cz/2013/event"> http://docs.Oasis-open.Org/wsn/bw-2/notificationproducer/subscribere...

  • Page 16: Createpullpoint

    16 2n telekomunikace a.S., www.2n.Cz ® expire_time specify the subscription date and time. Use the renew request to extend the subscription time before expiry. Refer to the format of selected parameters for format details. Createpullpoint the createpullpoint request helps you subscribe to event retr...

  • Page 17: Createpullpointresponse

    17 2n telekomunikace a.S., www.2n.Cz ® createpullpointresponse 2n helios ip ® sends the createpullpointresponse in reply to the createpullpoint request to inform the client that the client’s subscription has been completed successfully. Xmlns:s="http://www.W3.Org/2003/05/soap-envelope" xmlns:wsa5="h...

  • Page 18: Renew

    18 2n telekomunikace a.S., www.2n.Cz ® current_time subscription date and time from the viewpoint of . Refer to the format 2n helios ip ® of selected parameters for format details. Expire_time specify the subscription date and time. Use the renew request to extend the subscription time before expiry...

  • Page 19: Renewresponse

    19 2n telekomunikace a.S., www.2n.Cz ® renewresponse the renewresponse message is a reply to the renew request, in which 2n helios ip ® informs the client of the prolongation of the client’s subscription time. Xmlns:s="http://www.W3.Org/2003/05/soap-envelope" xmlns:wsa5="http://www.W3.Org/2005/08/ad...

  • Page 20: Message Parameters

    20 2n telekomunikace a.S., www.2n.Cz ® xmlns:s="http://www.W3.Org/2003/05/soap-envelope" xmlns:wsnt="http://docs.Oasis-open.Org/wsn/b-2" xmlns:event2n="http://www.2n.Cz/2013/event"> {subscription_id} xmlns:s="http://www.W3.Org/2003/05/soap-envelope" xmlns:wsnt="http://docs.Oasis-open.Org/wsn/b-2" xm...

  • Page 21: Message Parameters

    21 2n telekomunikace a.S., www.2n.Cz ® xmlns:s="http://www.W3.Org/2003/05/soap-envelope" xmlns:wsnt="http://docs.Oasis-open.Org/wsn/b-2" xmlns:event2n="http://www.2n.Cz/2013/event"> {subscription_id} {maximum_msgs_in_response} xmlns:s="http://www.W3.Org/2003/05/soap-envelope" xmlns:wsnt="http://docs...

  • Page 22: Message Parameters

    22 2n telekomunikace a.S., www.2n.Cz ® xmlns:s="http://www.W3.Org/2003/05/soap-envelope" xmlns:topic2n="http://www.2n.Cz/2013/event/topics" xmlns:wsa5="http://www.W3.Org/2005/08/addressing" xmlns:wsnt="http://docs.Oasis-open.Org/wsn/b-2" xmlns:event2n="http://www.2n.Cz/2013/event"> http://docs.Oasis...

  • Page 23

    23 2n telekomunikace a.S., www.2n.Cz ® event_list refer to the logged events subsection for the list of events. The message always includes one event at least. Specify the maximum count of events in the subscribe request..

  • Page 24: 5. Logged Events

    24 2n telekomunikace a.S., www.2n.Cz ® 5. Logged events this subsection includes a list of events to be stored in the log and 2n helios ip ® specifies the transfer format via the notify and getmessagesresponse messages. Keypressed callstatechanged cardentered codeentered devicestate see below for de...

  • Page 25: Callstatechanged

    25 2n telekomunikace a.S., www.2n.Cz ® 0, 1, …, 9, *, # – numerical keypad buttons %1..%54 – call buttons callstatechanged the callstatechanged event is generated whenever a change of the currently made call occurs. {timestamp} event2n:callstatechanged {state} {direction} event parameters timestamp ...

  • Page 26: Event Parameters

    26 2n telekomunikace a.S., www.2n.Cz ® event parameters timestamp event date and time; refer to the format of selected parameters. Card detected card identification with a 24-64-bit number in the hexadecimal format, e.G. 54a86b87c5. Valid_flag if the detected card is valid, the parameter value is . ...

  • Page 27: Devicestate

    27 2n telekomunikace a.S., www.2n.Cz ® devicestate the devicestate event is generated whenever any of the selected device state changes occurs. {timestamp} event2n:devicestate {state} event parameters timestamp event date and time; refer to the format of selected parameters. State event type specifi...

  • Page 28: 6. Format of Selected

    28 2n telekomunikace a.S., www.2n.Cz ® 6. Format of selected parameters timestamp – absolute time the absolute time parameter obeys the iso8601 subset standard: it is set as a string of characters in the ccyy-mm-ddthh:mm:ss format, where cc stands for the century, yy for the year, mm for the month a...

  • Page 29

    29 2n telekomunikace a.S., www.2n.Cz ® 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: sales@2n.Cz web: www.2n.Cz 2043v1.