Глубокий API для массовой проверки номеров WhatsApp

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

URL-адрес API

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

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

Глубокий API (Deep API) для массовой проверки номеров WhatsApp предлагает мощные аналитические возможности:

Демографический анализ

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

• Определение пола
• Оценку возраста
• Анализ цвета волос
• Определение цвета кожи/этноса

Атрибуты профиля

Комплексная информация о профиле включает:

• Проверку статуса аккаунта WhatsApp
• Извлечение URL-адреса фото профиля
• Классификацию типа изображения профиля
• Статус проверки аккаунта

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

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

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

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

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

Пример запроса

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

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

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

Следите за статусом обработки вашей задачи:

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

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

Ответ при создании задачи

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 0,
  "success": 0,
  "failure": 0
}

Ответ при статусе обработки

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:33:22.86152082Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "processing",
  "total": 20000,
  "success": 6724,
  "failure": 0
}

Ответ при завершении задачи

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:53:43.141760071Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "exported",
  "total": 20000,
  "success": 20000,
  "failure": 0,
  "result_url": "https://example-link-to-results.xlsx"
}

Поля результатов проверки номера WhatsApp

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

Коды состояния (Status Codes)

Примечания к интеграции

1. Каждая строка во входном файле должна содержать один телефонный номер в формате E.164.
2. Контролируйте статус задачи с помощью указанного task_id.
3. Загрузите результаты по ссылке result_url, когда статус станет “exported”.
4. Корректно обрабатывайте различные коды состояния (status codes) в вашем приложении.

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

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

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

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

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

3. Насколько точен демографический анализ?

Демографический анализ основан на передовой обработке изображений профиля искусственным интеллектом и обеспечивает оценку возраста, пола и других атрибутов (если они доступны).

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

API использует стандартные коды состояния HTTP для индикации успеха или неудачи:

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

5. Какова стоимость Глубокого API (Deep API)?

Цена составляет $6 USD за 10 000 номеров. Ответная информация этого API включает:

• Проверку статуса аккаунта WhatsApp
• Определение пола
• Оценку возраста
• Анализ типа изображения профиля
• Определение этнической принадлежности
• Анализ цвета волос

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