Il lettore di targhe NEDAP ANPR LUMO offre la lettura automatica delle targhe. La telecamera puó essere configurata tramite il suo interfaccia web. Per necessitá di integrazione le REST API sono disponibili. Le API possono essere usate per diversi scopi, come l'integrazione con la lista accessi disponibili
Un utile strumento per testare i comandi REST API dopo CURL é postman https://www.postman.com/
Nell'allegato puoi anche trovare degli esempi di POSTMAN link to attachment
La lista completa dei comandi é disponibile nel documento "ANPR LUMO Developerguide"
Login
L'endpoint API é usato per effettuare il login sul server con le proprie credenziali. Questo login é richiesto per effettuare qualsiasi altra azione sul server.
URL | Metodo | URL parameter | Data parameter |
/login | post | None | login_string |
Parameter
login_string
stringa con il seguente formato : "username=your_username&password=your_password"
Esempi:
# login
curl --cookie cookies.log --cookie-jar cookies.log http://192.168.3.15/login --data "username=admin&password=secret"
IO digitali
Sulla telecamra i pin digitali IO possono essere usati con l'Endpoint API per il recupero dello stato dei pin e per l'attivazione/disattivazione delle uscite disponibili. Il metodo GET può essere utilizzato per ottenere lo stato di tutti i pin e PATCH per impostare lo stato di un pin di uscita.
URL | Method | URL Parameter | Data parameter |
/digitalio | GET | none | none |
/digitalio | PATCH | none | :value |
Parametri
Valore che specifica il pin di uscita e lo stato da impostare su un determinato pin. Il valore è la struttura JSON con il seguente formato:
parameter | Value Format |
:value | { "index": pin number <integer>, "set": true per attivare o false per disattivare il pin selezionato } |
esempi
# login
curl --cookie cookies.log --cookie-jar cookies.log http://192.168.3.15/login --data "username=admin&password=secret"
# ricevi lo stato degli IO digitali
curl --cookie cookies.log --cookie-jar cookies.log -X GET http://192.168.3.15/digitalio
# attiva lo stato del pin output #1
curl --cookie cookies.log --cookie-jar cookies.log -X PATCH http://192.168.3.15/digitalio --data '{"index":1, "set":true}'
Recupera i risultati di Testo (Text results):
Questo endpoint API restituisce una quantità specificata degli ultimi risultati che sono stati catturati dalla telecamera ANPR LUMO.
nota: è necessario prima di tutto abilitare la memorizzazione dei risultati di testo nel front-end della Lumo. É possibile farlo modificando la lunghezza massima dell'elenco storico e le ore dell'elenco.
URL | Method | URL Parameter | Data parameter |
/text/results | GET | none | json |
/text/results | DELETE | none | json |
esempi:
# login
curl --cookie cookies.log --cookie-jar cookies.log http://192.168.3.15/login --data "username=admin&password=secret"
# recupera 5 risultati
curl --cookie cookies.log --cookie-jar cookies.log -X GET http:// 192.168.3.15/text/results
--data '{"count":5}'
# recupera 5 risultati con le immagini
curl --cookie cookies.log --cookie-jar cookies.log -X GET http:// 192.168.3.15/text/results
--data '{"count":5,"include_images":true}'
# recupera 10 risultati con una confidenza minima del 60 percento
curl --cookie cookies.log --cookie-jar cookies.log -X GET http:// 192.168.3.15/text/results
--data '{"count":10,"min-confidence":60}'
RICEVI e CONFIGURA le LISTE di ACCESSO (GET and SET)
Endpoint API per il recupero e l'aggiunta delle liste di accesso dell'ANPR LUMO. Ci sono quattro liste:
- lista bianca listname = 'white.txt'.
- lista nera listname = 'black.txt'.
- lista da ignorare listname = 'ignore.txt'.
- wiegand matchlist listname = 'wiegandlist.txt'.
Utilizza il metodo GET per recuperare la proprietà e il metodo PATCH per configurarla.
URL | Method | URL Parameter | Data parameter |
/access/:listname | GET | :listname | :filter (optional, can be empty) |
/access/:listname | PATCH | :listname | :entries |
/access/:listname | DELETE | :listname | :specifier |
Recuperare una lista di accesso:
Con una richiesta GET viene restituito l'elenco delle targhe. Le targhe possono essere filtrate inviando un documento JSON contenente un campo pattern che contiene un'espressione regolare (RegEx).
Aggiungere una targa ad una lista di accesso:
Con una richiesta POST è possibile aggiungere una nuova targa per la lista di accesso. La richiesta POST deve contenere un documento JSON nello stesso formato del documento di risposta alla richiesta GET.
Cancellare una targa da una lista di accesso:
Con una richiesta di DELETE, una o più targhe possono essere cancellate specificando uno dei due campi in un documento JSON all'interno della richiesta:
- index - cancella una singola voce con il numero di indice indicato
- pattern - cancella ogni targa che corrisponde al modello dato.
Esempi
# richiedi whitelist
curl --cookie cookies.log --cookie-jar cookies.log http://192.168.3.15/access/white.txt
# aggiungi la targa HHKF1114 alla whitelist
curl --cookie cookies.log --cookie-jar cookies.log -X POST http://192.168.3.15/access/white.txt
--data '[{"always":true,"plate":"HHKF1114"}]'
# aggiungi HHKF1115 alla whitelist che é valida dal 01-10-2019 fino al 31-10-2019 di lunedí , martedí e mercoledí dalle 08:00
fino alle 18:30
curl --cookie cookies.log --cookie-jar cookies.log -X POST
http://192.168.3.15/access/white.txt --data '[{"always":false,"plate":"HHKF1115","schedules":[{"period":{"start":"2019-10-01",
"end":"2019-10-31"},"time-span":{"from":"08:00","to":"18:30"},"weekdays": ["Mo","Tu","We"]}]}]'
# richiedi la Wiegand matchlist
curl --cookie cookies.log --cookie-jar cookies.log http://192.168.3.15/access/wiegandlist.txt
# aggiungi la targa HHKF1116 alla Wiegand matchlist e assegnale Wiegand ID 213
curl --cookie cookies.log --cookie-jar cookies.log -X POST http://192.168.3.15/access/wiegandlist.txt --data
'[{"always":true,"plate":"HHKF1116", "id": 213}]'
# cancella la targa con numero di indice 1 dalla whitelist
curl --cookie cookies.log --cookie-jar cookies.log -X DELETE http://192.168.3.15/access/white.txt
--data '{"index":1}'
# cancella le targhe con campo HH dalla whitelist
curl --cookie cookies.log --cookie-jar cookies.log -X DELETE http://192.168.3.15/access/white.txt
--data '{"pattern":"HH*"}'