5.2.3 api firmware reject

Funkce api/firmware/reject slouží k odmítnutí nahraného souboru s firmwarem.

Metody
  • GET

  • POST

Služby a privilegia
  • Služby: System API

  • Privilegia: Systém – Řízení

 

Požadavek PUT

Požadavek obsahuje soubor v URL.


Tabulka 1. Parametry požadavku


ParametrPovinnýOčekávané hodnotyVýchozí hodnotaPopis

fileId

Ano

Identifikátor firmwarového souboru

-

Tento parametr se musí shodovat s identifikátorem aktuálně nahraného firmwaru.

 

Příklad požadavku GET nebo POST

http://192.168.1.1/api/firmware/reject?fileId=7d6adf16


Odpověď na GET nebo POST

Odpověď je ve formátu application/json. Obsahuje klíč success. Je-li success true, firmware je odmítnut a s pomocí funkce api/firmware je možno nahrát nový soubor.


Příklad odpovědi na GET nebo POST

{ "success" : true }

Vrátit se mohou tyto konkrétní chybové kódy:

  • Error code 12
  • parametr = "fileId"

  • popis = "neplatný parametr"

  • Identifikátor souboru je neplatný (např. obsahuje jiné než hexadecimální znaky).

  • Error code 14
  • popis = "nový firmware nenalezen"

  • Není nahrán žádný firmwarový soubor s tímto fileId.

Upozornění

  • Zařízení neodpovídá na požadavky api/firmware 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.