Intelligent Security API (ANPR) Part 2

Uploaded by

pedrokampos2024

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

89 views13 pages

Intelligent Security API (ANPR) Part 2

Uploaded by

pedrokampos2024

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

You are on page 1/ 13

How to Integrate with ANPR

camera via ISAPI

What is ISAPI
The OPEN Intelligent Security Application Programming Interface (ISAPI) is a text protocol in RESTful style
based on HTTP for communicating between security devices/servers (e.g., cameras, DVR, NVR, Access Control,
etc.) and client software/system. It defines the communication standard between device/server and client
software/system via the Internet Protocol (IP).

How to get ISAPI document

Our partners need to register in TPP website(https://tpp.hikvision.com/) to sign MLA or apply by OA process

Before you integrate with ANPR camera, it’s better to get the following tools:

 Postman(https://www.postman.com/downloads/)
 Wireshark
 Notepad++(optional) (https://notepad-plus.en.softonic.com/)
Typical Scenario
Low Speed Scenario: for instance, parking lot, entrance and exit, oil station etc.

License Plate Info

3rd Platform

ANPR Camera
01 Recommended camera list - ISAPI
Camera list Firmware Features - ISAPI
Upload ANPR ANPR matched Upload vehicle Control barrier Speed GPS and time
with Pictures alarm characteristics measurement upload

Low speed DS-2CD4A26FWD V5.4.7 or above √ √ X √ X X

scenario

DS-2CD7026G0/P, V5.5.60 or above √ √ X √ X X

DS-2CD7A26G0/P
How to digest login
1. You need to login the terminal by digest, you can refer to the chapter4 Login in General document.
2. About the digest authentication, you can refer to chapter 3.1 Authentication(General document). see
https://tools.ietf.org/html/rfc2617 for details.

You also can use postman to test as below:

How to use postman for more functions
After login the device, we can use postman to test more functions, for example we can GET/PUT
listening server.
GET method: PUT method:

Note: When you use PUT or POST method, please pay attention to the body of method in document.
How to get real time events – arming mode
If you want to get the license recognition events, there’re two modes for getting the events. One is arming mode,
you can refer to the chapter 5.1 Receive Alarm/event in Arming Mode(ANPR document). You can use
/ISAPI/Event/notification/alertStream to receive alarm/event, but can’t test through postman. You can use
Wireshark or Chrome to test arming mode.

Note: You can use notepad++ to open the real time data flow, it will never stop, unless you close the browser.
How to get real time events – listening mode
Here is other mode - listening mode, you can refer to the chapter 5.2 Receive Alarm/event in Listening
Mode(ANPR document). You can use /ISAPI/Event/notification/httphosts/<ID> to configure the listening
address and port of HTTP listening server to receive the alarm, the device will automatically upload the alarm
information to the server.

Note: The “URL” is for locating the uploading

event, you can find this parameter in the packet
of next page

Note: Recommend listening mode for ANPR integration.

How to get real time events – listening mode
You also can use Wireshark to follow TCP stream, if the license was recognized, you can get the event in your
listening server, device also will upload 2 pictures, one for big picture, another for license picture, both of them
are binary data without encryption, you can translate it to JPEG directly. And the data upload by device in Json
format.
How to get real time events – listening mode
If you’re sure that you set the server IP and port correctly, and the port is open and not occupied. But you still
can’t receive the event, please use this URL “/ISAPI/Traffic/ANPR/alarmHttpPushProtocol”. Make sure this
parameter is “true”. If not, you need to use PUT method to change it.
How to get history picture files
If you want to realize the function like the web page below, you can use “/ISAPI/ContentMgmt/search” to
get the history picture files.
How to get history records in cache (20 records at most)
If you want to get the information like the web page below, use “/ISAPI/Traffic/channel/1/vehicleDetect/plates” to
get these information. If you want to get the picture, you can use “{cameraIp}/doc/ui/images/plate/{picName}.jpg”.
How to import/export Blacklist & Whitelist File
If you want to realize the function like the web page below, use “/ISAPI/Traffic/channels/1/licensePlateAuditData”
to GET/PUT the Blacklist & Whitelist file. Please refer to 6.17 in the ANPR document.