Как TG Validator проверяет номер Telegram

Выполнение одной проверки

Этот раздел посвящён проверкам в реальном времени: панель SaaS и синхронные эндпоинты REST используют один сервис проверки и одинаковое значение ответа. Для очень больших списков есть асинхронный массовый вариант — он описан в конце страницы.

1. 1

   Отправьте номер

   Отправьте один номер в формате E.164 с кодом страны, как описано в документации API.

2. 2

   Используйте service_type=tg

   Продукт tg проверяет, был ли номер зарегистрирован в Telegram на момент проверки.

3. 3

   Прочитайте результат

   Прочитайте registered в том же ответе. Запустите новую проверку, когда понадобится обновлённый статус.

В каком формате отправлять номер

TG Validator принимает один номер на проверку в формате E.164: знак плюс, код страны, затем номер абонента без пробелов и знаков препинания — например, +17253100591. В этом же формате номера хранит само приложение Telegram, поэтому номер в такой записи соответствует ровно одному аккаунту. Номер без кода страны нельзя надёжно проверить: одни и те же цифры существуют во многих странах.

• Всегда указывайте код страны; не рассчитывайте на страну вашего аккаунта.
• Удаляйте пробелы, дефисы, скобки и ведущие нули, используемые при внутреннем наборе, — оставляйте только + и цифры.
• Номера в неверном формате отклоняются до списания; отклонённый формат — это не результат «не зарегистрирован».

Что означает registered?

registered — это ответ проверки Telegram. Он присутствует только в успешном ответе и имеет логический тип: true означает, что номер зарегистрирован в Telegram на момент запроса, false — что нет. Всё остальное — тайм-аут, неопределённый результат, недопустимый номер — возвращается как код ошибки, и TG Validator автоматически возвращает средства за такую проверку. Поэтому отсутствие поля registered никогда не означает «не зарегистрирован»; это значит, что проверка не дала результата. Значение отражает момент запроса: аккаунты постоянно создаются и удаляются, поэтому повторяйте проверку перед тем, как действовать на основе старого результата, а не кешируйте его на недели.

• registered=true означает «зарегистрирован».
• registered=false означает «не зарегистрирован».
• Другие исходы обрабатывайте по коду ответа API; не выводите значение registered самостоятельно.

Используйте результат в пределах его назначения

Проверка отражает статус на момент запроса. Это не подтверждение личности и не разрешение связываться с человеком.

• Проверка не подтверждает, кому принадлежит номер, находится ли владелец в сети в данный момент, и не раскрывает содержимое сообщений; продукты проверки активности возвращают дни активности (дни с последнего посещения), а не текущее присутствие в сети.
• Статус «зарегистрирован» не означает согласия на контакт с этим номером.
• Запускайте новую проверку, когда для бизнес-решения нужен актуальный статус.

Очень большие списки: асинхронный вариант

Множественная проверка в панели и эндпоинт множественной проверки API подходят для большинства списков. Только если список намного превышает эти лимиты, имеет смысл отправить весь файл как одну асинхронную массовую задачу — вы выбираете страну, к которой относится список, и он должен в основном состоять из номеров этой страны.

• Загрузите файл .txt или .csv с одним номером E.164 на строку — на странице массовой проверки или через API.
• При отправке выберите страну, к которой относятся номера; список должен в основном состоять из номеров этой страны. Если номеров из других стран слишком много, задача завершится ошибкой при подготовке файла — она не будет отправлена на проверку, и сумма вернётся полностью.
• При отправке баланс резервируется за допустимые строки, списание идёт только за номера, по которым получен результат, а разница возвращается.
• Задача выполняется в фоне; скачайте файл с результатом после завершения. За неудавшуюся задачу сумма возвращается полностью.