GetHLRListBaseNumberInfo

Метод GetHLRListBaseNumberInfo

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

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

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

Авторизация

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

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

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

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

ПараметрТипОписание
date_fromstringдата начала выборки запросов в формате RFC-3339 / ISO-8601
date_tostringдата окончания выборки запросов в формате RFC-3339 / ISO-8601
limituint32лимит выводимых строк
offsetuint64номер строки, с которой начинать выборку (начинается с 0)

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

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

Elements

ПараметрТипОписание
application_uuidstringидентификатор приложения, из которого отправлены запросы
create_datestringдата отправки запроса
numberuint64номер, по которому получены данные
owner_idstringидентификатор оператора, обслуживающего номер
region_codeuint32код региона, в котором куплена SIM-карта номера список кодов регионов
mnpboolпараметр, показывающий, был ли перенос номера от одного оператора к другому. 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
        }
    ]
}

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

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