По сессиям
Для получения выгрузки по сессиям используется метод report/sessions:
POST https://api.novaconnect.kz/api/report/sessions
{
"filter": {
"start": <string>,
"end": <string>
},
"select": <array>,
"page": <int>,
"size": <int>
}
Параметры
| Параметр | Тип | Описание | Обязательность |
|---|---|---|---|
| select | array | Массив данных, по которым составляется отчет | Нет |
| filter.start | string | Дата начала (в формате ДД-ММ-ГГГГ) | Нет |
| filter.end | string | Дата конца (в формате ДД-ММ-ГГГГ) | Нет |
| page | int | Номер страницы (нумерация с 0) | Нет |
| size | int | Размер страницы | Нет |
Параметр select
В параметр необходимо передавать массив данных в виде:
- all - чтобы получить данные по всем доступным сим-картам;
- s_id - чтобы получить данные по сим-карте с идентификатором id
- g_id - чтобы получить данные по сим-картам, входящим в группу с идентификатором id
Ограничения и доступы
Метод доступен пользователю с любой ролью
Успешный ответ
В результате возвращается информация о постановке в очередь.
{
"code": 200,
"message": <string>,
"result": {
"items": [
{
"sid": <int>,
"start": <int>,
"end": <int>,
"country_name": <string>,
"operator_name": <string>,
"operator_code": <int>,
"session_cost": <float>,
"value": <bigint>,
"id": <int>,
"original_number": <string>,
"iccid": <string>,
"name": <string | null>
}
]
}
}
| Параметр | Тип | Описание |
|---|---|---|
| code | int | Код ответа, для успеха - 200 |
| message | string | Сообщение ответа |
| result.item.sid | int | Идентификатор сессии |
| result.item.start | int (UnixTimeStamp) | Дата и время начала сессии |
| result.item.end | int (UnixTimeStamp) | Дата и время окончания сессии |
| result.item.country_name | string | Сырое название страны (как хранится у верхнеуровнего оператора) |
| result.item.operator_name | string | Сырое название оператора (как хранится у верхнеуровнего оператора) |
| result.item.operator_code | int | Идентификатор оператора (MCC + MNC) |
| result.item.session_cost | float | Стоимость сессии в евро (только для сим профиля TC) |
| result.item.value | bigint (string) | Количество переданного и принятого трафика в сессии |
| result.item.id | int | Идентификатор сим-карты |
| result.item.original_number | string | Номер сим-карты |
| result.item.iccid | string | ICCID сим-карты |
| result.item.name | string/null | Название сим-карты |
Дополнительная информация
Синхронизация сессий с базами данных операторов происходит раз в сутки. Например, сессия была 25.06.2024, в отчет она попадет только после синхронизации 26.06.2024