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

{{>toc}}

Возвращает список CDR по учетной записи

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

|*аргумент*|*описание*|
|_login|совпадает с логином пользователя/компании к личному кабинету|
|_password|совпадает с паролем пользователя/компании к личному кабинету|
|date_from|UTC время (кол-во секунд с 1970-01-01 00:00:00)|
|date_to|UTC время (кол-во секунд с 1970-01-01 00:00:00)|

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

|*аргумент*|*описание*|
|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)|

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

|status|"ok", если операция завершилась без ошибки,
"error", если произошла ошибка, или если не удалось вернуть полезные данные|
|data|полезные данные, когда status = "ok"|
|errors|ошибки, когда status = "error"|
|calldate|UTC время начала звонка (кол-во секунд с 1970-01-01 00:00:00)|
|src|номер звонящего|
|dst|набранный номер|
|duration|общая длительность звонка|
|billsec|отвеченная длительность звонка|
|uniqueid|уникальный ID звонка, соответствует uniqueid из [[HTTP интерфейс active_calls|active_calls]] и [[HTTP интерфейс recordings|recordings]]|
|channelid|уникальный ID ноги звонка|
|sessionid|уникальный ID сессии, сессия может содержать несколько ног|
|direction|направление звонка по отношению к Smartswitch,
"inbound" - звонок приходит от пользователя в Smartswitch,
"outbound" - звонок приходит от Smartswitch к пользователю|
|hangupcause|Q.931 код завершения звонка (см. [[Коды завершения Q.931]])|

h2. Пример

|*запрос*|GET "https://имя.вашего.сервера/api/cdr?_login=LOGIN&_password=PASSWORD&date_from=1539621667&date_to=1539631667"|
|*ответ*|<pre>
{
  "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"
}</pre>|

[[HTTP API cdr|English translation]]