Что известно о номере телефона
Сервис отвечает на вопрос «может ли такой номер существовать вообще и как он правильно записывается». Отвечает справочник мировой нумерации — мгновенно и без единого обращения в сеть оператора. На вопрос «работает ли этот конкретный номер» сервис не отвечает: это сведения об абоненте.
Разбор номера — с бесплатным лимитом
Разбор номера работает локально и ничего нам не стоит, поэтому доступен с бесплатным суточным лимитом, а сверх лимита стоит символических денег. Оплата по факту, без подписок и скрытых комиссий. Строка, которая телефонным номером не является, не тарифицируется вовсе: работы по ней не было.
Преимущества сервиса
Всё, что говорит о номере справочник мировой нумерации
Строгая валидность
Номер сверяется с реально выделенными диапазонами страны, а не только с длиной.
Четыре формата
E.164, международный, национальный и RFC 3966 для атрибута href.
Мгновенно и офлайн
Справочник вкомпилирован в сервис: ответ за миллисекунды, без внешних вызовов.
REST API
Простой HTTP GET с JSON-ответом — для форм регистрации и нормализации баз.
Как это работает
Два способа разобрать номер телефона
Графический интерфейс
Введите номер — получите карточку с разбором и пояснениями, как её читать.
- Валидность, четыре формата записи, тип номера
- Страна, оператор диапазона, регион, часовые пояса
- Прямое пояснение, что именно означает «валидный номер»
REST API
Встройте валидацию номеров в формы регистрации и в нормализацию базы через простые HTTP GET запросы.
-
/api/phone/{number}— разбор номера -
?countryCode=RU— для номеров без «плюса» - JSON-ответ и спецификация OpenAPI
Что сервис даёт и чего не даёт
Сервис работает со справочником нумерации, а не со сведениями об абонентах. Разница принципиальная, и лучше узнать о ней до покупки, а не после.
Мировой план нумерации — открытые сведения о том, какие диапазоны номеров выделены в каждой стране, каким операторам и под какой тип связи. Из него и берётся ответ.
Всё, что относится к конкретному человеку за номером, хранится в сети его оператора. Получить это можно только запросом в сеть — а такой запрос раскрывает сведения о человеке, который о проверке не просил. Мы таких запросов не делаем.
Что важно понимать про результат
Три вещи, из-за которых сервис чаще всего понимают неправильно
Оператор — исходный, а не фактический
Справочник знает, кому диапазон номера выделили изначально. С 2013 года абонент вправе перенести номер к другому оператору, сохранив его (MNP), и справочник об этом не узнает. Перенесённых номеров в России миллионы, поэтому для произвольного номера оператор в ответе — обоснованная догадка, а не факт. Не стройте на нём тарификацию звонков и выбор SMS-маршрута.
«Валидный» — это не «рабочий»
Валидный номер записан правильно и попадает в выделенный диапазон. Принадлежит ли он кому-то и включён ли телефон — сервис не знает и не проверяет. Верно и обратное: реально работающий номер иногда помечен невалидным, если справочник нумерации страны отстал от реальности. Для таких случаев есть более мягкий признак «возможный номер».
У почты картина полнее
Существование почтового ящика проверить можно: сервис «Проверка почты» обращается к почтовому серверу домена. У телефона такого способа нет — есть только запрос в сеть оператора, раскрывающий персональные данные. Отсюда и разные названия: почту мы проверяем, телефон только валидируем.
Часто задаваемые вопросы
Короткие ответы про валидацию номеров
Примеры использования
Где помогает валидация телефона
Регистрация и формы
Отсекайте опечатки и заведомо несуществующие номера до отправки кода подтверждения.
Нормализация базы
Приводите номера к единому виду E.164 и проставляйте страну — так они станут сравнимы.
Отбор перед рассылкой
Не тратьте SMS на строки, которые не являются номерами, и на стационарные номера.
Время звонка
Часовые пояса диапазона помогают не звонить клиенту среди ночи по его местному времени.
Готовы начать?
Откройте GUI для быстрого разбора номера или используйте API для автоматизации.
Валидность
По диапазонам страны
Форматы
E.164 и ещё три вида
Офлайн
Без запросов в сеть
REST API
JSON + Swagger