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>, //Идентификатор сим-карты
      "iccid": <string>, //ICCID сим-карты
  "number": <string>, //Основной номер сим-карты
  "external_number": <string>, //Дополнительный номер сим-карты
  "name": <string | null>, //Название сим-карты
  "balance": <float>, //Баланс сим-карты
  "currency": <string>, //Валюта баланса
  "msu_value": <int | null>, //Количество MSU
  "profile": <string>, //Профиль
  "block": <string>, //Тип блокировки
  "comment": <string | null>, //Комментарий системы
  "groups": [],
  "limit": {
      "type": <string>, //Тип лимита
      "value": <int | null>, //Установленное значение лимита
      "used": <int | null>, //Использованный лимит
      "updated": <int | null>, //Дата обновления поля used
      "created": <int | null> //Дата установки лимита
  },
  "tariff": {
      "id": <int>, //Идентификатор тарифного плана
      "name": <string>, //Название тарифного плана
      "change_lock": <int | null>, //Дата снятия блокировки на смену ТП
 "package_auto": <bool> //Флаг автоматического подключения пакета при истечении
  }
 }
],
  "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>, //Переподключение пакета
"dealer": <bool>, //Возможность передачи сим другой компании
    "group": <bool> //Изменение групп
  },
  "message": <string> //Сообщение о результате
}