Тип номера
по плану нумерации
Мобильный, городской или 8-800, регион выдачи и часовой пояс — по одному номеру или пакетом до 1000 за запрос.
{
"query": "+7 962 730-23-71",
"suggestions": [
{
"source": "89627302371",
"phone": "+7 962 730-23-71",
"type": "mobile",
"is_valid": true,
"country_code": "7",
"city_code": "962",
"number": "7302371",
"extension": null,
"country": "Россия",
"region": "Республика Саха (Якутия)",
"city": null,
"timezone": "UTC+9",
"qc": 0,
"qc_conflict": 0
}
]
}
Возможности тип номера
Тип линии
Мобильный, городской или 8-800 — по плану нумерации Минцифры.
Регион и часовой пояс
Субъект, за которым закреплён номер, и время там прямо сейчас.
Пакет до 1000
Ответ в том же порядке; нераспознанная строка помечена, а не пропущена.
Поля ответа 14
Ответ — структурированный JSON: каждый уровень отдельным полем, коды и координаты рядом со значением.
/v1/find/phone
Что такое определение типа номера
Номер телефона говорит о себе больше, чем кажется: по нему видно, мобильный это или городской, в каком регионе он выдан и который там сейчас час. Метод проверяет номер по плану нумерации Минцифры — это около 450 тысяч диапазонов, за которыми закреплён каждый код и каждый номер в России. На вход — номер в любом написании, хоть «8 (962) 730-23-71», на выход — тип линии, нормализованный номер, регион, город для стационарных и часовой пояс. Если строка вовсе не похожа на номер, ответ это прямо помечает.
Как подключить определение типа номера
Метод вызывают там, где решение зависит от типа номера: в форме регистрации — чтобы отправлять код подтверждения только на мобильный, в CRM — чтобы выбрать канал связи, в колл-центре — чтобы звонить в рабочее время клиента. Базу проверяют пакетом: до 1000 номеров за запрос, ответ приходит в том же порядке, поэтому его легко положить рядом с исходной таблицей. Каждый номер — один запрос дневного лимита тарифа, на бесплатном тарифе это до 10 000 запросов в день. Для старта нужен ключ из личного кабинета с доступом к телефону.
Что важно знать про определение типа номера
Регион — это субъект, за которым номер закреплён в плане нумерации, а не место, где сейчас находится абонент. Тип и регион определяются для российских номеров; у номеров других стран приходят страна, тип и формат по международному плану нумерации. Метод не сообщает, кому принадлежит номер, и не проверяет, включён ли телефон прямо сейчас: это сведения, которые составляют тайну связи. Кто обслуживает номер после переноса, показывает отдельный продукт — «Оператор номера».
Как определить тип номера телефона: мобильный или городской
Тип номера определяется по коду и диапазону: мобильные номера в России начинаются с кода 9xx, городские — с географических кодов вроде 495 или 383, а 8-800 — бесплатный вызов для звонящего. Метод сверяет номер с планом нумерации целиком, а не по первой цифре, поэтому знает и о диапазонах, которые выделили недавно. Это закрывает задачу NT-запроса — проверки типа номера, которую SMS-агрегаторы продают отдельной услугой.
Регион и часовой пояс по номеру телефона
Вместе с типом приходит регион, где выдан номер, а для стационарных — ещё и город. Часовой пояс считается по региону: клиенту в Якутии разница с Москвой шесть часов, и обзвон по московскому утру его разбудит. Колл-центры ставят звонки по местному времени абонента, а сервисы доставки подбирают окно уведомлений без ночных SMS.
Проверка номеров пакетом через API
В одном запросе — до 1000 номеров. Ответ сохраняет порядок входа: строка, которая не похожа на номер, не выпадает из списка, а приходит с пометкой. Так базу на сотни тысяч записей разбирают в один проход и сразу видят, какие номера мобильные, какие городские, а какие — мусор, на который не стоит тратить рассылку.
Проверка номера
Проверка входит в дневной лимит тарифа: каждый номер, в том числе в пакете, — один запрос. На бесплатном тарифе — до 10 000 запросов в день.
Частые вопросы про определение типа номера
- Сколько стоит проверка типа номера?
- Проверка входит в дневной лимит тарифа: номер — один запрос. На бесплатном тарифе это до 10 000 запросов в день — хватит, чтобы встроить метод и проверить его на своём трафике.
- Чем тип номера отличается от проверки оператора?
- Тип говорит, что это за линия и где она выдана. Оператор — кто обслуживает номер сейчас, с учётом переноса. Оба приходят из одного метода /v1/find/phone: тип — на любом тарифе, оператор и перенос — на тарифе «Бизнес».
- Можно ли проверить сразу всю базу?
- Да. Номера отправляются пакетами по 1000, ответ приходит в том же порядке. Нераспознанные строки помечены — их видно сразу, а не после неудачной рассылки.
- Можно ли узнать, включён ли телефон или кто его владелец?
- Нет. Метод работает с открытым планом нумерации: тип, регион и часовой пояс. Активность номера и данные абонента составляют тайну связи, их сервис не определяет.
- Подойдут ли номера других стран?
- Да, для них приходят страна, тип номера и формат по международному плану нумерации. Регион, город и часовой пояс — только для российских номеров.
Адреса
Подсказки и стандартизация по ГАР/ФИАС: индекс, КЛАДР, кадастр, гео.
Компании и ИП
Поиск по названию, ИНН, ОГРН, КПП, почте и руководителю: реквизиты, ОПФ, статус, филиалы.
ФИО
Разбор на части, определение пола, регистр и склонение по падежам.
Кадастровый поиск
Адрес по кадастровому номеру и живой поиск по кварталу. Оплата за запрос.
Чистые данные за один запрос
Проверяйте номера по одному или пакетом до 1000. Бесплатно до 10 000 запросов в день.