HTTP интерфейс cdr¶
- Table of contents
- HTTP интерфейс cdr
Возвращает список CDR по учетной записи
Обязательные аргументы¶
аргумент | описание |
_login | совпадает с логином пользователя/компании к личному кабинету |
_password | совпадает с паролем пользователя/компании к личному кабинету |
date_from | UTC время (кол-во секунд с 1970-01-01 00:00:00) |
date_to | UTC время (кол-во секунд с 1970-01-01 00:00:00) |
Необязательные аргументы¶
аргумент | описание |
with_unanswered | 1 - возвращать неотвеченные, 0 - не возвращать неотвеченные (по умолчанию 0) |
with_sessionid | 1 - возвращать атрибут session ID, 0 - не возвращать атрибут session ID (по умолчанию 0) |
with_channelid | 1 - возвращать атрибут channel ID, 0 - не возвращать атрибут channel ID (по умолчанию 0) |
with_direction | 1 - возвращать атрибут "направление звонка", 0 - не возвращать атрибут "направление звонка" (по умолчанию 0) |
with_hangupcause | 1 - возвращать атрибут "код отбоя", 0 - не возвращать атрибут "код отбоя" (по умолчанию 0) |
Возвращаемые данные¶
status | "ok", если операция завершилась без ошибки, "error", если произошла ошибка, или если не удалось вернуть полезные данные |
data | полезные данные, когда status = "ok" |
errors | ошибки, когда status = "error" |
calldate | UTC время начала звонка (кол-во секунд с 1970-01-01 00:00:00) |
src | номер звонящего |
dst | набранный номер |
duration | общая длительность звонка |
billsec | отвеченная длительность звонка |
uniqueid | уникальный ID звонка, соответствует uniqueid из active_calls и recordings |
channelid | уникальный ID ноги звонка |
sessionid | уникальный ID сессии, сессия может содержать несколько ног |
direction | направление звонка по отношению к Smartswitch, "inbound" - звонок приходит от пользователя в Smartswitch, "outbound" - звонок приходит от Smartswitch к пользователю |
hangupcause | Q.931 код завершения звонка (см. Коды завершения Q.931) |
Пример¶
запрос | GET "https://имя.вашего.сервера/api/cdr?_login=LOGIN&_password=PASSWORD&date_from=1539621667&date_to=1539631667" |
ответ | { "data" : [ { "calldate" : "1539621667", "src" : "100", "dst" : "12123388100", "duration" : "30", "billsec" : "10", "uniqueid" : "1539621667.443" }, { "calldate" : "1539621668", "src" : "100", "dst" : "12123388101", "duration" : "60", "billsec" : "50", "uniqueid" : "1539621668.444" } ], "status" : "ok" } |