Как проверить CSV с номерами телефонов на регистрацию в Telegram в реальном времени

Техническое руководство по проверке CSV с номерами телефонов на регистрацию в Telegram в реальном времени с TG Validator: подготовка данных, синхронные одиночный и множественный эндпоинты, управление параллельностью и интерпретация результатов.

TG Validator проверяет регистрацию в Telegram в реальном времени: отправьте один номер в формате E.164 на POST /api/v1/check или до 100 номеров на синхронный множественный эндпоинт POST /api/v1/batch-check, и готовый результат вернется в том же HTTP-ответе. Чтобы проверить CSV, приведите столбец к формату E.164, отправляйте его через множественный эндпоинт до 100 идентификаторов в запросе и управляйте параллельностью на стороне клиента в соответствии с документацией API. Целый файл, намного превышающий один запрос в реальном времени, также можно загрузить как асинхронное задание массовой проверки.

Подготовка данных к проверке

При обработке CSV с контактами первым шагом нужно стандартизировать входные данные. TG Validator требует, чтобы все отправляемые номера телефонов были в формате E.164. Этот международный план нумерации гарантирует глобальную уникальность каждого номера; обычно номер начинается с «+», за которым следуют код страны и номер абонента. Если привести столбец CSV к формату E.164 до отправки запросов к API, это предотвратит ошибки недопустимого номера телефона и позволит системе точно проверить статус регистрации в Telegram.

Как устроен процесс работы с TG Validator API

Основная модель TG Validator — синхронный запрос-ответ как для одиночных, так и для множественных проверок. Используйте POST /api/v1/check для одного номера или синхронный множественный эндпоинт POST /api/v1/batch-check с service_type=tg для до 100 идентификаторов в формате E.164 из CSV; оба возвращают результат в том же HTTP-ответе — без отправки задания, опроса или скачивания.

Управление пропускной способностью и лимитами API

Обрабатывайте CSV через синхронный множественный эндпоинт, до 100 идентификаторов в запросе, и соблюдайте механизмы контроля использования API платформы. TG Validator применяет лимит параллельности для каждого пользователя, поэтому уточните актуальное значение в документации API, прежде чем решать, сколько запросов ваш скрипт будет держать открытыми. Для целого файла, намного превышающего один запрос в реальном времени, также доступно асинхронное задание массовой проверки (загрузка, ожидание, скачивание); его актуальные лимиты приведены в документации API. Если ваш скрипт превысит эти пороги, API вернет специальные коды ошибок, указывающие, что все слоты параллельности заняты или что время на проверку истекло. Отказы такого рода не оплачиваются и не создают результата проверки. Задержка или очередь с ограничением параллельности в скрипте обработки CSV обеспечит плавное выполнение без лишних ошибок.

Интерпретация результатов и обработка ошибок

API возвращает задокументированную обертку ответа, содержащую code, msg и data. Для проверок Telegram сигнал наличия аккаунта передается в поле data.registered. Для завершенной проверки Telegram возвращаемый объект data содержит только service_type, identifier и registered; внутренние поля записи, транзакции, статуса и биллинга не возвращаются.

Часто задаваемые вопросы

В каком формате должны быть номера телефонов для проверки?

Все номера телефонов должны передаваться в формате E.164, который обеспечивает глобальную уникальность каждого номера: он начинается с «+», за которым следуют код страны и номер абонента.

Что произойдет, если превысить лимит параллельности?

Если вы превысите задокументированный лимит параллельности, API вернет код ошибки. Такие отказы из-за лимитов не оплачиваются и не создают результата проверки.

Можно ли проверить несколько номеров в одном запросе?

Да. Синхронный множественный эндпоинт POST /api/v1/batch-check принимает до 100 идентификаторов в формате E.164 и возвращает готовые результаты в том же HTTP-ответе. Для целого файла, намного превышающего этот объем, также доступно асинхронное задание массовой проверки (при отправке вы выбираете страну, к которой относятся номера, и список должен по существу состоять из номеров этой одной страны), но синхронные эндпоинты остаются основным способом проверки.