GetHLRListBaseNumberInfo

Метод GetHLRListBaseNumberInfo

Примените метод GetHLRListBaseNumberInfo для получения истории запросов базовой информации по номерам (регион регистрации SIM-карты, обслуживающий оператор, факт переноса SIM к другому оператору).

Точка подключения: Выполните POST-запрос с входными параметрами к точке подключения:

POST: https://api.exolve.ru/statistics//hlr/v1/GetHLRListBaseNumberInfo

Авторизация

Передайте следующие Заголовки HTTP для успешной авторизации.

Имя Тип Описание
Authorization string API-ключ приложения с Bearer перед ним. Пример: Bearer e***s0, где e***s0 замените на API-ключ вашего приложения

Входные параметры

Передайте следующие параметры в теле запроса в JSON-формате. Параметры, отмеченные жирным шрифтом, являются обязательными.

Параметр Тип Описание
date_from string дата начала выборки запросов в формате RFC-3339 / ISO-8601
date_to string дата окончания выборки запросов в формате RFC-3339 / ISO-8601
limit uint32 лимит выводимых строк
offset uint64 номер строки, с которой начинать выборку (начинается с 0)

Выходные параметры

Параметр Тип Описание
elements Elements номер, по которому получено лучшее время для звонка

Elements

Параметр Тип Описание
application_uuid string идентификатор приложения, из которого отправлены запросы
create_date string дата отправки запроса
number uint64 номер, по которому получены данные
owner_id string идентификатор оператора, обслуживающего номер
region_code uint32 код региона, в котором куплена SIM-карта номера список кодов регионов
mnp bool параметр, показывающий, был ли перенос номера от одного оператора к другому. True — номер был перенесён к другому оператору. False — переноса номера не было

Примеры

Входные параметры:

{
    "date_from": "2023-10-01T08:49:28.446495Z",
    "date_to":"2025-11-29T08:49:28.446495Z",
    "limit": 10,
    "offset": 0
}

Выходные параметры:

{
    "elements": [
        {
            "application_uuid": "9e8f4cfc-d87f-4c3d-a87b-1be22df13e10",
            "create_date": "2025-05-18T15:11:58.377210Z",
            "number": "7918013XXXX",
            "owner_id": "mMTS",
            "region_code": "23",
            "mnp": false
        },
        {
            "application_uuid": "9e8f4cfc-d87f-4c3d-a87b-1be22df13e10",
            "create_date": "2025-04-21T14:33:20.282897Z",
            "number": "7999874XXXX",
            "owner_id": "mJUTA",
            "region_code": "55",
            "mnp": true
        },
        {
            "application_uuid": "9e8f4cfc-d87f-4c3d-a87b-1be22df13e10",
            "create_date": "20245-04-20T12:12:45.447456Z",
            "number": "7910451XXXX",
            "owner_id": "mBEELINE",
            "region_code": "77",
            "mnp": false
        }
    ]
}

Возможные ошибки

Код Статус Пример сообщения Описание
400 Bad Request rpc error: code = InvalidArgument desc = date_from later than date_to невалидные значение в date_from
400 Bad Request rpc error: code = InvalidArgument desc = Failed to validate GetHLRStats request невалидные значение в обязательных полях
400 Bad Request proto: (line 3:14): invalid google.protobuf.Timestamp value “***” невалидное значение в одном из обязательных параметров (с указанием строки)
400 Bad Request proto: syntax error (line 3:44): unexpected token не задано значение в одном из полей (с указанием строки)
400 Bad Request proto: syntax error (line 3:44): invalid value невалидное значение в одном из обязательных параметров (с указанием строки)
401 Unauthorized error while trying to get token from header нет заголовка авторизации
401 Unauthorized failed to parse token невалидный API-ключ
404 Not Found некорректно введен URL запроса

Содержание статьи