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"
}
]
}
}
