CGI/snapshot API kamer — statický obrázek snap.jpg

Co je snapshot (CGI) URL

Kamery a rekordéry PATRONUM nabízejí kromě RTSP video streamů také jednoduché CGI rozhraní, které na HTTP požadavek vrátí aktuální statický snímek ve formátu JPEG. Nadřazený systém (chytrá domácnost, vrátný panel, vlastní skript) si snímek stáhne vždy, když ho potřebuje — typicky po zazvonění nebo při detekované události. Právě tento mechanismus používá například LOXONE pro zobrazení obrázku z kamery.

Formáty adres

IP kamera

http://IPadresa:HTTPport/snap.jpg
http://uzivatel:heslo@IPadresa:HTTPport/snap.jpg (přihlašovací údaje přímo v adrese)

IP adresa – adresa kamery v síti (např. 192.168.1.168)
HTTP port – HTTP port kamery (výchozí 80; pokud byl změněn, ověřte ho v síťovém nastavení zařízení)
uzivatel / heslo – uživatelský účet v kameře, stejný jako pro webové rozhraní (výchozí: admin)

JPEG stream (opakované snímky): http://IPadresa:HTTPport/live.htm

PoE NVR rekordér

http://IPadresaNVR:HTTPport/snap.jpg?channel=1

Parametr channel určuje číslo kanálu v NVR. Snímky z kamer připojených přímo do PoE portů takto umí sdílet všechny nové PoE NVR rekordéry a vybrané starší modely po aktualizaci firmwaru.

Upozornění: Rekordér musí být nastaven pro lokální zobrazení na TV/monitoru na domovské obrazovce (náhled kamer). Pokud je na obrazovce spuštěn úvodní průvodce nebo otevřené menu, soubory JPEG se nevytvářejí.

Kompletní přehled adres včetně RTSP streamů najdete v článku Formátování adres streamů.

Autentizace: Basic vs. Digest

Při stažení snímku se zařízení ptá na přihlašovací údaje stejného uživatele, jakým se hlásíte do webového rozhraní. Existují dva běžné způsoby HTTP autentizace:

• Basic — jméno a heslo se posílají přímo s požadavkem a lze je zapsat i do URL ve tvaru uzivatel:heslo@adresa. Podporuje ji naprostá většina systémů třetích stran.
• Digest — bezpečnější mechanismus výzva–odpověď. Některé systémy třetích stran ho ale nepodporují — například Loxone ve své dokumentaci uvádí, že Digest autentizaci nepodporuje.

Který způsob zařízení vyžaduje, závisí na verzi firmwaru a v nastavení zařízení ho zpravidla nelze přepnout. Z praxe naší podpory známe případ, kdy po aktualizaci firmwaru kamery přestal statický obrázek v Loxone fungovat (místo snímku se zobrazil jen otazník), přestože stejná URL v prohlížeči snímek normálně vracela. Pokud vás tento problém potká, kontaktujte podporu s modelem zařízení a přesnou verzí firmwaru — návrat na starší firmware není možný a chování je třeba posoudit individuálně.

Diagnostika krok za krokem

1. Otevřete snapshot URL v prohlížeči na počítači ve stejné síti. Pokud se zobrazí aktuální snímek z kamery, CGI rozhraní funguje a kamera je v pořádku.
2. Prohlížeč snímek ukáže, integrace ne? Problém je na straně nadřazeného systému — nejčastěji způsob autentizace (viz Basic vs. Digest výše), překlep v adrese, špatný HTTP port nebo chybějící parametr channel u NVR.
3. Neukáže ho ani prohlížeč? Ověřte IP adresu a HTTP port v síťovém nastavení zařízení, přihlašovací údaje a u NVR rekordéru i to, že je na domovské obrazovce s náhledem kamer.
4. Přestalo to fungovat po aktualizaci firmwaru? Chování snapshot rozhraní se může mezi verzemi firmwaru lišit. Ozvěte se podpoře s názvem modelu a přesnou verzí firmwaru — obojí najdete ve webovém rozhraní zařízení.

Použití v praxi

• LOXONE — kamera nebo NVR se přidává jako uživatelsky definovaný interkom a snapshot URL slouží jako „URL Videostream". Podrobný postup: Jak přidat zařízení PATRONUM do LOXONE.
• Synology Surveillance Station — snapshot rozhraní nepotřebujete, kamery se integrují přes ONVIF nebo RTSP. Postup: Jak přidat IP kameru PATRONUM do Synology Surveillance Station.
• Vlastní integrace (domácí automatizace, skripty) — snapshot URL lze použít kdekoliv, kde umíte stáhnout obrázek přes HTTP.

Bezpečnostní doporučení

• Přihlašovací údaje zapsané v URL se přenášejí v čitelné podobě — snapshot adresy používejte pouze v lokální síti.
• HTTP port kamery nikdy nevystavujte přímo do internetu; pro vzdálený přístup použijte P2P připojení nebo VPN. Více v článku Jak zabezpečit kamery před hackem.
• Po aktualizaci firmwaru vždy ověřte, že integrace postavené na snapshot URL stále fungují.

Časté otázky

Jaký je výchozí HTTP port?

Výchozí HTTP port kamer a rekordérů PATRONUM je 80. Pokud byl při instalaci změněn, aktuální hodnotu najdete v síťovém nastavení ve webovém rozhraní zařízení.

Proč vidím snímek v prohlížeči, ale Loxone ukazuje jen otazník?

Nejčastější příčinou je autentizace — pokud firmware zařízení vyžaduje Digest autentizaci, Loxone ji podle své dokumentace nepodporuje. Způsob autentizace závisí na verzi firmwaru; kontaktujte podporu s modelem a verzí firmwaru.

Funguje snap.jpg i pro kamery zapojené v PoE portech rekordéru?

Ano, přes adresu rekordéru s parametrem channel: http://IPadresaNVR:HTTPport/snap.jpg?channel=1. Podporují to všechny nové PoE NVR rekordéry a vybrané starší modely po aktualizaci firmwaru. Rekordér přitom musí být na domovské obrazovce s náhledem kamer.

Můžu se vrátit ke starší verzi firmwaru, se kterou snapshot fungoval?

Ne, zpětná aktualizace (downgrade) firmwaru není možná. Pokud po aktualizaci narazíte na změnu chování snapshot rozhraní, obraťte se na podporu — chování závisí na verzi firmwaru a posoudíme ho individuálně.