GetBaseNumberInfo

Метод GetBaseNumberInfo

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

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

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

Авторизация

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

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

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

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

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

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

ПараметрТипОписание
numberuint64номер, по которому получена оценка активности
owner_idstringидентификатор оператора, обслуживающего номер
region_codeuint32код региона, в котором куплена SIM-карта номера список кодов регионов
network_codestringкод страны (первые 3 цифры) и код оператора (последние 2 цифры)
mnpboolпараметр, показывающий, был ли перенос номера от одного оператора к другому. True — номер был перенесён к другому оператору. False — переноса номера не было

Примеры

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

{
    "number": "79139999999"
}

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

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

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

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