Простой API для массовой проверки номеров WhatsApp

WhatsApp является глобальной доминирующей платформой для обмена сообщениями, и проверка статуса аккаунтов в больших масштабах может дать ценную информацию для бизнеса. В этой статье представлен Простой API для массовой проверки номеров WhatsApp (Simple API), который позволяет эффективно проверять статус аккаунтов WhatsApp для нескольких номеров одновременно.

Основные функции

Простой API для массовой проверки номеров WhatsApp предлагает базовые возможности проверки:

Проверка аккаунта

Быстрая и надежная проверка статуса аккаунта WhatsApp для любого номера телефона по всему миру.

Массовая обработка

Обрабатывайте несколько номеров одновременно с помощью загрузки файла, что делает эту функцию эффективной для масштабных проверок.

Обновление статуса в реальном времени

Отслеживайте ход выполнения задач массовой проверки с обновлениями статуса в реальном времени.

Шаги по использованию

Загрузка файла

Загрузите текстовый файл, содержащий номера телефонов в формате E.164:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"/path/to/file.txt"' \
--form 'task_type="ws"'

Получение данных задачи

Для проверки статуса используйте POST https://api.checknumber.ai/v1/gettasks с полем формы task_id (см. curl ниже). Старые пути /wa/api/simple/... не используются.

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="TASK_ID"'

Параметры запроса

• file: Файл, содержащий номера для проверки.
• task_type: значение ws для проверки регистрации в WhatsApp. См. официальную документацию.

Параметры ответа

• task_id: ID задачи.
• created_at: Время создания задачи.
• updated_at: Время последнего обновления задачи.
• status: Статус задачи.
• total: Общее количество номеров в задаче.
• success: Количество успешно проверенных номеров.
• failure: Количество номеров с ошибкой проверки.
• result_url: URL-адрес для загрузки файла с результатами.

Тело запроса

Тело ответа

Поля результатов

API возвращает базовую информацию о проверке, включая:

• Номер телефона (формат E.164)
• Статус аккаунта WhatsApp (yes/no)

Формат ответа API

API предоставляет подробную информацию о статусе задачи:

• created_at: Метка времени создания задачи
• updated_at: Метка времени последнего обновления статуса
• task_id: Уникальный идентификатор задачи
• status: Текущий статус задачи (pending/processing/completed/exported)
• total: Общее количество обработанных номеров
• success: Успешно обработанные номера
• failure: Неудачные попытки обработки
• result_url: URL-адрес для скачивания готовых результатов

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

1. Какова пропускная способность API?

API может эффективно обрабатывать большие пакеты номеров с обновлениями статуса выполнения в реальном времени.

2. В каком формате должен быть входной файл?

Входной файл должен быть текстовым файлом, в котором каждый номер телефона указан на новой строке в формате E.164 (например, +79123456789).

3. Какую информацию возвращает API?

API возвращает базовую информацию для проверки: имеется ли у телефонного номера активный аккаунт WhatsApp или нет.

4. Каковы коды статуса ответов API?

• 200: Успешный запрос (взимается плата)
• 400: Неверные параметры или формат файла (бесплатно)
• 500: Внутренняя ошибка сервера (бесплатно)

5. Какова стоимость API?

Цена составляет 1 доллар США за 10 000 номеров для базовой проверки статуса аккаунта WhatsApp.

Для получения дополнительной информации о ценах и больших объемах обработки, пожалуйста, свяжитесь с нами.