h1. HTTP интерфейс active_calls

{{>toc}}

Возвращает список текущих активных звонков, которые поступают на внутренние телефоны, для данной учетной записи.
Обычно этот API используется в режиме опроса каждые 5-10 секунд CRM системами.
При обнаружении входящего звонка, CRM система может отображать [[Карточка контакта|Карточку контакта]].

h2. Обязательные аргументы

|*аргумент*|*описание*|
|_login|совпадает с логином пользователя/компании к личному кабинету|
|_password|совпадает с паролем пользователя/компании к личному кабинету|

h2. Возвращаемые данные

|status|"ok", если операция завершилась без ошибки,
"error", если произошла ошибка, или если не удалось вернуть полезные данные|
|data|полезные данные, когда status = "ok"|
|errors|ошибки, когда status = "error"|
|calleridnum|внутренний номер, на который идет вызов|
|connectedlinenum|номер звонящего|
|connectedlinename|имя звонящего|
|state|состояние звонка|
|uniqueid|уникальный ID звонка, соответствует uniqueid из [[HTTP интерфейс cdr|cdr]] и [[HTTP интерфейс recordings|recordings]]|

h2. Пример

|*запрос*|GET "https://имя.вашего.сервера/api/active_calls?_login=LOGIN&_password=PASSWORD"|
|*ответ*|<pre>
{
  "data" : [
    {
      "calleridnum" : "12123388100",
      "connectedlinenum" : "123737373737",
      "connectedlinename" : "John",
      "state" : "Ringing",
      "uniqueid" : "121223123.333"
    },
    {
      "calleridnum" : "12124599066",
      "connectedlinenum" : "123445435567",
      "connectedlinename" : "Michael",
      "state" : "Ringing",
      "uniqueid" : "12122545.334"
    }
 ],
 "status" : "ok"
}</pre>|

[[HTTP API active_calls|English translation]]