Обнаружение Номеров WhatsApp — Массовая Проверка через Платформу или API | CheckNumber.AI

API проверки номеров WhatsApp — интеграция

Массовая верификация регистрации в WhatsApp нужна для очистки списков, антифрода, скоринга лидов и валидации CRM. Ниже — интеграция bulk API CheckNumber.AI с примерами curl, Python и Node.js.

Как это работает

В продакшене используются пакетные задачи: загрузить файл → опросить статус → скачать результат — не один синхронный HTTP на каждый номер. Позволяет эффективно обрабатывать большие объёмы данных.

Документация: WhatsApp Checker — bulk registration.

Создать задачу

POST https://api.checknumber.ai/v1/tasks

curl:

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

Python:

import requests

url = "https://api.checknumber.ai/v1/tasks"
headers = {"X-API-Key": "YOUR_API_KEY"}

with open("numbers.txt", "rb") as f:
    files = {"file": f, "task_type": (None, "ws")}
    response = requests.post(url, headers=headers, files=files)

print(response.json())

Node.js:

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const form = new FormData();
form.append('file', fs.createReadStream('numbers.txt'));
form.append('task_type', 'ws');

axios.post('https://api.checknumber.ai/v1/tasks', form, {
  headers: {
    ...form.getHeaders(),
    'X-API-Key': 'YOUR_API_KEY'
  }
}).then(res => console.log(res.data))
  .catch(err => console.error(err.message));

Статус задачи

POST https://api.checknumber.ai/v1/gettasks

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

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

Ошибки

FAQ

Сколько времени займёт большой файл? Зависит от очереди — обычно секунды или несколько минут.
Размер файла? Минимум 1 номер, максимум ~50 МБ.
Оплата только за успех? Успешно обработанные строки расходуют кредиты по правилам биллинга.

Дальше

• 1 000 бесплатных проверок →
• Тарифы →
• Документация API →

Заметки

1. По одному номеру на строку; E.164 с кодом страны.
2. Опрашивать до exported, затем result_url.
3. Официальная документация.
4. Цены: pricing.