Синхронная проверка
Как проверить регистрацию номера телефона в Telegram в реальном времени
Отправьте один номер телефона в формате E.164 и получите статус его регистрации в Telegram в том же синхронном ответе API.
Продукт отвечает на один точный вопрос
TG Validator проверяет, зарегистрирован ли отправленный номер телефона в Telegram на момент запроса.
Продукт принимает один номер телефона в формате E.164, использует service_type=tg и возвращает завершенный результат в том же HTTP-ответе. Нет идентификатора задания для опроса и не нужен обратный вызов, прежде чем приложение сможет прочитать data.registered.
Охват продукта ограничивается статусом регистрации. Ответ не содержит имени пользователя Telegram, профиля, статуса активности, контактов, групп или данных сообщений. Он также не идентифицирует человека, который пользуется номером телефона. Это не скрытые функции — они просто не входят в контракт продукта.
Завершенный false — не то же самое, что неудачная проверка
| Возвращенные данные | Решение о регистрации | Как использовать |
|---|---|---|
code=0, registered=true |
Зарегистрирован на момент проверки | Используйте true как результат этого запроса |
code=0, registered=false |
Не зарегистрирован на момент проверки | Используйте false как результат этого запроса |
| Ненулевой бизнес-код | Решения о регистрации нет | Не создавайте логическое значение; обработайте ошибку или повторите запрос согласно документации API |
Это различие важно, потому что registered=false — полезная информация, полученная в результате завершенной проверки. Ошибка API возвращается во внешней структуре ответа со своим HTTP-статусом и числовым code; это не еще одно значение data.registered.
Путь синхронного запроса
- Подготовьте входные данные в E.164 — исходите из известного контекста страны и нормализуйте номер к виду: знак плюс, код страны и цифры.
- Аутентифицируйте запрос — используйте ключ API, созданный в разделе «Настройки», и передайте его в задокументированном заголовке.
- Выберите продукт Telegram — укажите
service_type=tg; не определяйте продукт по посторонним полям. - Дождитесь ответа на тот же запрос — проверка синхронная, поэтому приложение получает решение без опроса.
- Считайте точные поля результата — используйте
data.registeredприcode=0; оставляйте его пустым, если API возвращает ненулевой бизнес-код. - Зафиксируйте время проверки — рассматривайте результат как текущее наблюдение, а не бессрочную гарантию.
Где полезна работа в реальном времени
Синхронный контракт хорошо подходит для ПО, которому нужно одно актуальное решение о регистрации, прежде чем продолжить работу. Оператор может проверить запись в панели, внутреннее приложение — проверить отправленный номер, а фоновый обработчик — обрабатывать записи по одной.
Для небольшого списка синхронный пакетный эндпоинт принимает до 100 идентификаторов в формате E.164 и возвращает завершенный пакет в исходном ответе. Планирование и параллельность остаются на стороне клиента. Это сохраняет простоту контракта API: у каждого завершенного результата один входной номер, один результат регистрации в Telegram и одно время наблюдения.
Минимальная запись в приложении
Используйте явные поля вместо размытой метки valid:
| Поле | Назначение |
|---|---|
source_phone |
Сохраняет значение, переданное исходной системой |
e164_phone |
Хранит канонический номер, который был проверен |
service_type |
Фиксирует tg как контракт результата |
outcome |
Классификация в вашем приложении: завершено, можно повторить или запрос не удался |
registered |
Хранит true/false только для завершенных проверок |
checked_at |
Отметка времени наблюдения за регистрацией |
Если приложению нужен более свежий ответ, оно должно выполнить еще один синхронный вызов. Не следует менять отметку времени у старого значения или выдавать кэшированное значение за данные в реальном времени.
Правило интеграции, которое предотвращает ложные данные
code=0 подтверждает, что логическое значение registered — это завершенный ответ о регистрации.
Такая двухэтапная интерпретация не допускает попадания проблем с входными данными и временных состояний сервиса в поле статуса Telegram. Она также делает обещание продукта точным: TG Validator синхронно предоставляет актуальное наблюдение за регистрацией, когда проверка завершается, а интегрирующая система сама решает, когда ей нужно новое наблюдение.