5.7.2 api call dial
Funkce /api/call/dial umožňuje iniciovat nový odchozí hovor na zvolené telefonní číslo nebo sip uri pomocí parametru number nebo na jednoho či více uživatelů pomocí parametru users. Příkaz smí obsahovat pouze jeden z uvedených parametrů, v opačném případě bude vrácena odpověď s chybovým hlášením.
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 – řízení.
Pro tuto funkci lze použít metody GET nebo POST.
Parametry požadavku:
Parametr | Popis |
---|---|
number | Povinný parametr specifikující cílové telefonní číslo nebo sip uri. |
users | Seznam uuid (unikátní ID) uživatelů oddělenými čárkami. |
Odpověď je ve formátu application/json a obsahuje informace o vytvořeném odchozím hovoru.
Parametr | Popis |
---|---|
session | Identifikátor hovoru, který lze použít např. pro sledování hovoru pomocí funkce /api/call/status, příp. pro ukončení hovoru funkcí /api/call/hangup. |
Příklad:
GET /api/call/dial?number=sip:1234@10.0.23.194 { "success" : true, "result" : { "session" : 2 } }