WhatsApp API проверки активности: определение активности аккаунта

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

Пример загрузки файла:

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

Пример проверки статуса задачи:

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

Ответ при успешной загрузке файла:

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Ответ для статуса обработки:

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Ответ при завершении задачи (включает URL скачивания результата):

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}

URL запроса загрузки файла

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

Параметры запроса загрузки файла

Параметр	Описание
`file`	`file`, Загрузите файл; каждая строка должна содержать номер в формате E.164
`task_type`	`string`, Тип задачи, установите “ws_active”

URL запроса проверки статуса

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

Параметры запроса проверки статуса

Параметр	Описание
`task_id`	`string`, ID задачи, возвращаемый при создании

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

Поле	Описание	Пример
`Number`	Номер телефона в формате E.164	+12025551234
`whatsapp_days`	Продолжительность активности учетной записи WhatsApp в днях	1, 7, 30, N/A
`whatsapp_business`	Есть ли у номера активная учетная запись WhatsApp Business	yes, no
`signature`	Сведения о подписи учетной записи WhatsApp	Hello World, N/A

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

Поле	Описание
`created_at`	Время создания задачи
`updated_at`	Время последнего обновления статуса задачи
`task_id`	Уникальный идентификатор задачи
`user_id`	Идентификатор пользователя
`status`	Статус задачи: `pending`: в очереди и ожидает обработки `processing`: обрабатывается `exported`: результаты доступны для скачивания
`total`	Всего обработано номеров телефонов
`success`	Номера успешно определены
`failure`	Номера, которые не удалось обработать
`result_url`	Необязательно: URL для скачивания результатов при статусе `exported`

Коды статуса

Статус	Описание
`200`	`charge`, запрос успешно выполнен, задача создана или получен ее статус
`400`	`free`, неверный запрос, недопустимые параметры или формат файла
`500`	`free`, внутренняя ошибка сервера, повторите попытку позже