5.7.1 api call status
Funkce /api/call/status slouží k získání aktuální stavu probíhajících telefonního hovorů. Funkce vrací seznam probíhajících hovorů a jejich parametry.
Funkce je součástí služby Phone/Call a v případě použití autentizace je nutné, aby uživatel měl přiřazené privilegium Telefon/hovory – sledování.
Pro tuto funkci lze použít metody GET nebo POST.
Parametry požadavku:
Parametr | Popis |
---|---|
session | Volitelný parametr obsahující identifikátor hovoru, jehož stav se má vrátit. Pokud parametr není uveden, funkce vrací stav všech probíhajících hovorů. |
Odpověď je ve formátu application/json a obsahuje seznam probíhajících hovorů (pole sessions) a jejich aktuální stav. V případě použití parametru session obsahuje pole sessions právě jednu položku. Pokud aktuálně neprobíhá žádný hovor, pole sessions je prázdné.
Parametr | Popis |
---|---|
session | Identifikátor hovoru. |
direction | Směr hovoru (incoming – příchozí, outgoing – odchozí) |
state | Stav hovoru (connecting, ringing, connected) |
Příklad:
GET /api/call/status { "success" : true, "result" : { "sessions" : [ { "session" : 1, "direction" : "outgoing", "state" : "ringing" } ] }