5.3.1 api config

Funkce /api/config slouží k uploadu nebo downloadu konfigurace zařízení.

Funkce je součástí služby System a v případě použití autentizace je nutné, aby uživatel měl přiřazené privilegium Systém (řízení).

Pro tuto funkci lze použít metody GET nebo POST pro download konfigurace nebo metodu PUT pro upload konfigurace.

Parametry požadavku pro metodu PUT:

Parametr

Popis

blob-cfg

Povinný parametr obsahující konfiguraci zařízení (ve formátu XML).

Pro metody GET/POST nejsou definovány žádné parametry.

V případě downloadu konfigurace je odpověď ve formátu application/xml a obsahuje kompletní konfigurační soubor zařízení.

Funkce /api/config s použitím metody PUT provádí upload konfigurace se zpožděním cca 15 s, během tohoto intervalu se zařízení nesmí resetovat ani vypínat.

Příklad:

 GET /api/config
<?xml version="1.0" encoding="UTF-8"?>
<!--
        Product name: 2N IP Vario
       Serial number: 08-1860-0035
    Software version: 2.10.0.19.2
    Hardware version: 535v1
  Bootloader version: 2.10.0.19.1
             Display: No
         Card reader: No
-->
<DeviceDatabase Version="4">
<Network>
	<DhcpEnabled>1</DhcpEnabled>
	...
	...

V případě uploadu konfigurace je odpověď ve formátu application/json a neobsahuje žádné další parametry.

Příklad:

PUT /api/config
{
  "success" : true
}

Upozornění

  • Po přechodu na verzi 2.24 dojde ke zrušení pozic uživatelů v adresáři. Při aktualizaci adresáře je nejprve potřeba stáhnout současnou konfiguraci, v této konfiguraci provést požadované změny a poté znovu nahrát.
  • Při nedodržení postupu může dojít ke ztrátě dat.