Метод 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 запроса |