Skip to main content

Список сим-карт

В данный момент метод перерабатывается, возможны изменения

Для получения списка сим-карт используется метод sim/list:

POST https://api.novaconnect.kz/api/sim/list

{
  "page": <int>,
  "size": <int>,
  "filter": {
    "profile": <string>,
    "msu_block": <bool>,
    "blocked": <bool>,
    "company": <array of string>
  },
  "sort": <object>
}
Параметры
Параметр
Тип
Описание
Обязательность
page
int
Номер страницы (начало с 0)
Нет
size
int
Размер страницы (по-умолчанию 25)
Нет
filter
object
Объект для фильтра (см. ниже)
Нет
sort
object
Объект для сортировки (см. ниже)
Нет

Параметр "filter"

Задает фильтрацию списка сим. Объект имеет следующие значения:

Параметр
Тип Описание
Допустимые значения
Обязательность
profile
string
Фильтр по столбцу "Профиль"
"tc", "td"
Нет
msu_block
bool
Отобразить только заблокированные по MSU

Нет
blocked
bool
Фильтр по блокировке

true - отобразить только заблокированные

false - отобразить только разблокированные

Нет
company
array
Массив компаний
"my", "all", идентификаторы компаний
Нет

Параметр "sort"

В объект передается ключ столбца, по которому идет сортировка, в значение - направление:

  • ASC - по возрастанию
  • DESC - по убыванию
Результат

Положительный результат выглядит следующим образом:

{
  "code": 200,
  "count": <int>, //Количество элементов в результате
  "all_count": <int>, //Общее количество элементов в БД
  "items": [
    {
      "id": <int>, //ID сим-карты
      "iccid": <string>, //ICCID сим-карты
      "number": <string>, //Номер телефона сим-карты
      "external_number": <string>, //Дополнительный номер телефона
      "name": <string | null>, //Название сим-карты
      "blocked": <bool>, //Флаг блокировки
      "balance": <float>, //Баланс сим-карты
      "currency": <string>, //Валюта баланса
      "limit_type": <string>, //Тип лимита
      "limit_value": <int|null>, //Ограничение лимита
      "limit_date": <int|null>, //Дата установки лимита
      "limit_value_used": <int|null>, //Количество использованного лимита
      "msu_lock": <bool>, //Флаг блокировки по MSU
      "msu_value": <int | null>, //Количество MSU
      "profile": <string>, //Профиль сим-карты
      "tariff_plan_change_lock": <bool | null>, //Флаг блокировки смены тарифа
      "tp_id": <int | null>, //ID тарифного плана
      "tp_name": <string | null>, //Название тарифного плана
      "package_auto": <bool>, //Флаг автопродления пакета
      "limit": <string>, //Текстовое описание лимита
      "network": <int>, //Статус сим-карты
      "danger": <int>, //Флаг предупреждений для сим-карты
      "comment": <string>, //Текстовое описание предупреждений для сим
      "groups": <array> //Массив идентификаторов групп
    }
],
  "allow_operations": { //Доступные операции
    "block": <bool>, //Блокировка
    "unblock": <bool>, //Разблокировка
    "disconnect": <bool>, //Сброс регистрации в сети (Cancel Location)
    "reconnect": <bool>, //Мягкая перезагрузка (POD)
    "ping": <bool>, //Пинг через СМС
    "sms": <bool>, //Отправка СМС
    "balance": <bool>, //Изменение баланса
    "edit": <bool>, //Редактирование название
    "limit": <bool>, //Установка лимита
    "tariff": <bool>, //Изменение тарифного плана
    "repackage": <bool>, //Переподключение пакета
    "group": <bool> //Изменение групп
  },
  "message": <string> //Сообщение о результате
}