4.4.1.3 Статусы пользователей продукта

POST /cc/get_presence

Параметры:

№ Параметры Тип Обяза-тель-ный Описание
1 abonent_id Целое Нет Идентификатор пользователя, передается если нужны данные конкретного пользователя
2 session_types Object Нет Массив строк. Фильтр типов сессий presence. Значения типов: - sip - sip сессии; - сс - сессии операторов в кц/цов; - mtm - сессии операторов в m.talker (мобильные версии); - mtd - сессии операторов в m.talker (настольные версии)

Примечание. Если привязки к пользователю не обнаружилось, то в ответ вернётся пустой объект.

Пример запроса:

POST https://app.mango-office.ru/cc/get_presence

vpbx_api_key = 1234567890qwerty,
sign = 1234567890qwerty,
json =

{
    "session_types": "cc"
}

В результате обработки запроса, формируются и передаются JSON-данные, содержащие следующие параметры:

№ Параметры Тип Обяза-тель-ный Описание
1 result Код результата
2 abonents Объекты в формате "данные абонента" (описание этого формата см. Ниже по тексту)

Пример ответа:

{
"result":1000,
"abonents":
{ abonent1 doc },
{ abonent2 doc },

//...

{ abonentN doc }

	}

Описание формата «Данные абонента»:

  • общие для всех типов:
  • uac - cтрока, идентификатор ПО пользователя (User Agent);
  • ip - строка, ip адрес пользователя;
  • timestamp - целое, время обновления в UTC;
  • poss - массив целых, возможности пользователя;
  • дополнительные поля для типа "sip":
  • uname - строка, учетная запись sip;
  • дополнительные поля для типа "cc":
  • status - целое, статус пользователя в КЦ;
  • device - строка, идентификатор устройства пользователя;
  • дополнительные поля для типов "mtd" и "mtm":
  • uname - строка, учетная запись sip зарегистрированная в M.Talker;
  • status - целое, статус пользователя в M.Talker;
  • device - строка, идентификатор устройства пользователя.

Общий формат документа для отдельного абонента:

{
"abonent_id": id,
"used_uac_type":  "uac1", "uac2", ... ,
"sip":
{ sess1 },

...
,

"mtm":
{ sess1 },

...
,

"mtd":
{ sess1 },

...
,

"сс":
{ sess1 },

...
,

"calls":
{ call1 },

...
}