5.2.1 api firmware
PUT
Služby: Systém API
Privilegia: Systém – řízení
Požadavek PUT
Požadavek obsahuje soubor ve formátu multipart/form-data.
Parametr | Povinný | Očekávané hodnoty | Výchozí hodnota | Popis |
---|---|---|---|---|
blob-fw | Ano | platný firmwarový binární soubor | - | Soubor s firmwarem |
Příklad požadavku PUT
http://192.168.1.1/api/firmware
Odpověď na PUT
Odpověď je ve formátu application/json. Obsahuje klíče success a result. Hodnota result obsahuje různé klíče popsané v následující tabulce.
Klíč | Typické vrácené hodnoty | Popis |
---|---|---|
fileId | náhodný identifikátor (8 HEX znaků) | Obsahuje náhodný identifikátor nahraného souboru s firmwarem. Identifikátor musí být použit k potvrzení nahraného firmwaru pomocí funkce api/firmware/apply nebo k odmítnutí nahraného firmwaru pomocí funkce api/firmware/reject. |
version | Řetězec s identifikací verze | Obsahuje identifikaci verze nahraného firmwaru. |
downgrade |
| Tento příznak je |
note | Řetězec s náhradními znaky (URL kódování) | Obsahuje aktualizační zprávu pro nahraný firmware (např. varování před velkými změnami). |
Příklad odpovědi na PUT
{ "success" : true, "result" : { "fileId" : "7d6adf16", "version" : "2.32.4.41.2", "downgrade" : false, "note" : "EN:\r\nVER=2.20.0\r\nSome changes associated with the downgrade to a lower version result in a loss of original settings in a certain part of configuration.\r\n\r\n* All the cards installed in the **Directory \/ Access cards** menu are moved to the **Directory \/ Users** menu as new users upon firmware upgrade. Each user is automatically named as !Visitor #n, where n gives the user number in the list. This change is irreversible upon downgrade.\r\n* Service cards are now available in the **Hardware \/ Card reader** menu.\r\n* All the user access ... ... ... \u043F\u0440\u043E\u0444\u0438\u043B\u0435\u043C \u043F\u043E\u043B\u044C\u0437\u043E\u0432\u0430\u0442\u0435\u043B\u044F.\r\n\r\n" } }
Vrátit se mohou tyto konkrétní chybové kódy:
Error code 12
param = "blob-fw"
popis = "neplatná hodnota parametru"
Nahraný firmware neodpovídá požadavkům (neplatný soubor, firmware pro jiné zařízení…)
Error code 19
popis = "verze souboru je nižší než požadovaná minimální verze"
Nahraný firmware má nižší verzi, než je pro zařízení povolena.
Upozornění
Zařízení neodpovídá na požadavky na nahrání dalšího firmwaru, když v něm existuje předchozí verze. Nejprve s pomocí funkce api/firmware/reject odmítněte předchozí verzi firmwaru a pak nahrajte jinou. Nahraný firmware bude za 5 minut automaticky odmítnut, pokud se nepoužije.