GetBaseNumberInfo

Метод GetBaseNumberInfo

Примените метод GetBaseNumberInfo, чтобы узнать оператора и регион номера абонента, а также был ли перенос номера от одного оператору к другому.

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

POST: https://api.exolve.ru/hlr/v1/GetBaseNumberInfo

Авторизация

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

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

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

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

Параметр Тип Описание
number string мобильный номер в формате 7ХХХХХХХХХХ, по которому нужно получить информацию

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

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

Примеры

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

{
    "number": "79139999999"
}

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

{
    "number": 79119999999,
    "owner_id": "mMTS",
    "region_code": 78,
    "network_code": "RU25001",
    "mnp": false
}

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

Код Статус Пример сообщения Описание
400 Bad Request incorrect number format неверный формат данных в запросе или отсутствуют обязательные параметры
400 Bad Request hlr is disabled on the application услуга HLR-запросов отключена, подключите её в настройках приложения
400 Bad Request customer has not signed, the number must match your confirmed phone number на тестовом периоде можно проверить только свой подтверждённый номер, в запросе указан иной
401 Unauthorized incorrect authorization token невалидный API-ключ
403 Forbidden нет доступа к данными с предоставленным API-ключом
404 Not Found некорректно введен URL запроса

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