Indoor Touch 2.0 HTTP API provides third party applications a possibility to configure and ® control selected system parts and the 2N IP Mobile calling application. Caution • The HTTP API service is licensed under the 91378395 2N Indoor Touch HTTP API license. 3 / 95...
2.2.3.3 Call Termination • 2.2.3.4 Call State • 2.2.3.5 2N IP Intercom List Getting • 2.2.3.6 Change of Items in Added 2N IP Intercom List • 2.2.3.7 Door Lock Activation • 2.2.3.8 2N® IP Mobile Minimization • 2.2.3.9 2N® IP Mobile State Info •...
Page 5
JSON data format, incorrect HTTP method, etc. ® • A 2N IP Mobile command is entered but the application is not running. Therefore, make ® sure that the application has been started before sending a 2N IP Mobile command. 5 / 95...
Page 6
2N® Indoor Touch 2.0 API The data container can include more items whose names and contents depend on the request to be sent. Our example includes an array of serial numbers. 2.1.4 Cautions Currently, API is used for both providing data to the web interface (REST) and user HTTP API requirements. Thus, the data that can be viewed and configured via the web can be available in...
Page 7
2N® Indoor Touch 2.0 API Response code 403 in the case of default password and its necessary change. 2.2.1.2 Logout The logout helps you log out the currently logged-in session. URL: http://<IP>/api/v1/logout HTTP method: Response code: 200 if everything is OK, otherwise 401, 405,...
Page 9
2N® Indoor Touch 2.0 API 2.2.2.2 GPIO Value Setting Set the output value, switchable IO direction or relay status change. Parameters Name – GPIO name, refer to 2.2.2.1 Getting List of GPIO Inputs and Outputs Value – can be {0, 1} ...
Page 12
2.2.3.3 Call Termination • 2.2.3.4 Call State • 2.2.3.5 2N IP Intercom List Getting • 2.2.3.6 Change of Items in Added 2N IP Intercom List • 2.2.3.7 Door Lock Activation • 2.2.3.8 2N® IP Mobile Minimization • 2.2.3.9 2N® IP Mobile State Info •...
Page 13
2N® Indoor Touch 2.0 API 2.2.3.2 Call Accept Accepts currently ringing incoming call. URL: https://<IP>/api/v1/call/accept HTTP method: Request body: Response code: Standard HTTP response code, treating syntactic errors. Response data: {"data":{"success":true}} 2.2.3.3 Call Termination Terminates the active call. URL: https://{{ip_addr}}/api/v1/hipm/call/hangup...
Page 14
Response data: "data": { "state": "Released" 2.2.3.5 2N IP Intercom List Getting ® Get the list of the 2N IP intercoms that are registered with 2N IP Mobile and can be displayed and edited in the device list. NNURL: https://{{ip_addr}}/api/v1/hipm/devices HTTP method: Response code: Standard HTTP response code, treating syntactic errors.
Page 15
2.2.3.6 Change of Items in Added 2N IP Intercom List Modify the list of added 2N IP intercoms. Parameters isActive – true or false id – get the 2N IP intercom ID from the list, refer to 2.2.3.5 Getting List of Available 2N IP Intercoms URL:...
Page 16
"id": 255, "isActive": true 2.2.3.7 Door Lock Activation Send a request to activate the door lock for a selected 2N IP intercom. Make sure that the 2N IP intercom serial number is in the list of added devices. URL: https://{{ip_addr}}/api/v1/hipm/devices/open HTTP method: Request body "switchId":1,...
Page 17
"string" Caution • The 2N IP intercom, whose door lock switch is to be activated must be active according to request 2.2.3.5 Getting List of Available 2N IP Intercoms. Switch the 2N IP intercom into the active state using request 2.2.3.6 Change of Items in List of...
Page 18
2N® Indoor Touch 2.0 API 2.2.3.9 2N® IP Mobile State Info Returns the information that the application is running and capable of processing communication. URL: https://<IP>/api/v1/hipm HTTP method: Request body: Response code: Standard HTTP response code, treating syntactic errors. Response data: "data": {...
Page 19
2N® Indoor Touch 2.0 API 2.2.4.1 System Info and Status As this is a WEB API function, the success value is not included in the response. Information on the system and its state is returned. URL: https://<IP>/api/v1/status HTTP method: Request body: Response code: Standard HTTP response code, treating syntactic errors.
Page 21
2N® Indoor Touch 2.0 API • upTimeLife – gives the total device operation time • upTimeRestart – gives the device operation time since the last restart • wifiMac – wi-fi interface MAC address • memory • available – currently available device memory size •...
Page 22
2N® Indoor Touch 2.0 API 2.2.4.2 2N® Indoor Touch Restart ® Restart the 2N Indoor Touch 2.0 unit. URL: https://<IP>/api/v1/maintenance/devicereset HTTP method: Request body: Response code: Standard HTTP response code, treating syntactic errors. 22 / 95...
2N® Indoor Touch 2.0 API 3. WEB API ® WEB API incudes a set of endpoints that are used in the 2N Indoor Touch 2.0 web interface. • 3.10 Maintenance • 3.11 Network • 3.1 Device info • 3.2 Application •...
Page 59
2N® Indoor Touch 2.0 API Response data: "data": { "isClockOnlyModeActive": false Get a list of applications available for the Homepage. URL: https://{{ip_addr}}/api/v1/homescreen/applications HTTP method: Response code: Standard HTTP response code, treating syntactic errors. 59 / 95...
Page 63
2N® Indoor Touch 2.0 API 3.6.1 Buttons Getting button list Get the current list of available buttons (programmable positions for application start). URL: https://{{ip_addr}}/api/v1/homescreen/buttons HTTP method: Response code: Standard HTTP response code, treating syntactic errors. 63 / 95...
Page 87
2N® Indoor Touch 2.0 API HTTP method: Response code: Standard HTTP response code, treating syntactic errors. Response data: "data": { "useWebPassword": true Access setting Set different access passwords for the web interface and system settings. URL: https://{{ip_addr}}/api/v1/maintenance/security HTTP method: Request body: "useWebPassword":...
Page 88
2N® Indoor Touch 2.0 API Response code: Standard HTTP response code, treating syntactic errors. 88 / 95...
Page 89
2N® Indoor Touch 2.0 API Response data: "data": { "accessSettingsPasswordType": Set the System settings access URL: https://{{ip_addr}}/api/v1/maintenance/security/ settings/access HTTP method: Request body: "accessSettingsPasswordType": "<integer>", "password": "<string>" Response code: Standard HTTP response code, treating syntactic errors. Response data: "data": { "accessSettingsPasswordType": 1, "password":...
Page 90
2N® Indoor Touch 2.0 API Request body: "password": "<string>" Caution Make sure that the password meets the minimum password setting requirements, refer to Security. Response code: Standard HTTP response code, treating syntactic errors. Response data: "data": { "password": "Test12345"...
Page 91
2N® Indoor Touch 2.0 API Change of current settings Caution You can only turn the lock screen off/on using this endpoint. The lock screen cannot be configured via a web interface. URL: https://{{ip_addr}}/api/v1/maintenance/security/ lockscreen HTTP method: Request body: "isEnabled": "<boolean>"...
2N® Indoor Touch 2.0 API 4. Supplementary Information • 4.1 Directives, Laws and Regulations – General Instructions and Cautions 4.1 Directives, Laws and Regulations – General Instructions and Cautions Please read this User Manual carefully before using the product. Follow all instructions and recommendations included herein.
Page 94
2N® Indoor Touch 2.0 API The consumer shall, without delay, change the access password for the product after installation. The manufacturer shall not be held liable or responsible for any damage incurred by the consumer in connection with the use of the original password.
Need help?
Do you have a question about the Indoor Touch 2.0 API and is the answer not in the manual?
Questions and answers