5.5.1 api io caps
Funkce /api/io/caps vrací seznam dostupných hardwarových vstupů a výstupů zařízení (portů). Funkce má volitelný parametr port, který určuje vstup/výstup, jehož vlastnosti se mají vrátit. Pokud parametr port není uveden, funkce vrací seznam všech vstupů a vstupů.
Funkce je součástí služby I/O a v případě použití autentizace je nutné, aby uživatel měl přiřazené privilegium Vstupy a výstupy – sledování.
Pro tuto funkci lze použít metody GET nebo POST.
Parametry požadavku:
Parametr | Popis |
---|---|
Port | Volitelný parametr definující identifikátor vstupu nebo výstupu. |
Odpověď je ve formátu application/json a obsahuje seznam portů (pole ports) a jejich aktuální nastavení. V případě použití parametru port obsahuje pole ports právě jednu položku.
Parametr | Popis |
---|---|
port | Identifikátor vstupu nebo výstupu |
type | Typ (input – pro digitální vstupy, output – pro digitální výstupy) |
Příklad:
GET /api/io/caps { "success" : true, "result" : { "ports" : [ { "port" : "relay1", "type" : "output" }, { "port" : "relay2", "type" : "output" } ] } }