How-to Setup IP Camera API Webhook Events

Home › Forums › Viewtron Security Camera Systems Support › IP Camera API › How-to Setup IP Camera API Webhook Events

  • Follow these setup instructions to enable outbound HTTP Post webhook calls when your Viewtron AI security camera detects objects and events. After your enable the HTTP Post server on your camera, you can use this documentation on AI security camera API events to develop your application.

    Please note if your camera is connected a PoE port on a Viewtron NVR, you must put the IP camera on your local network in order to access the IP camera API directly. Instead of connecting the IP camera to your NVR directly via the NVR PoE ports, you must connect it via the LAN by connecting it to a PoE switch external to the NVR.

    Log into your Viewtron IP camera through a web browser.

    IP Camera HTTP Post

    Click on the Network link on the left side menu, then click on the HTTP POST link.

    IP camera HTTP Post Settings

    On the HTTP Post / HTTP Notification screen, click on the Edit button then be sure that V1 is selected in the Push Protocol Version dropdown. Click Save.

    http post API server settings

    Next, click on the Add button.

    IP camera HTTP Post Server

    Then fill in the API server IP address, port, and path. Select Persistent connection from the connection Type dropdown. Set Heartbeat Interval to 30 seconds and check the Send Heartbeat Checkbox. You can also check off the type of alarms and data that you want the server to send. In my testing, I only wanted to send LPR events, so I only checked License Plate Detection in the Smart Alarm Type section. Be sure to check the Smart Alarm Data cehck box. Optionally check the Original and Target picture options if your application will be using the LPR snapshot images. If you are not using images, leave these unchecked as these increase the size of the HTTP Post payload significantly.

    When done, click the Save button.

    The IP camera is now setup to send webhook HTTP Posts to your server. If you are looking for a server to get you started with your development project. Mike developed one and open sourced it on Github. You can download Mike’s IP camera API server here and you can find the complete Viewtron API developers guide for IP cameras and NVRs here.