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.