WhatsApp API массовой проверки аватара, возраста и пола: анализ профиля

Проверьте сведения об аватаре WhatsApp для указанного международного номера: наличие учетной записи, URL фотографии профиля, пол, возраст, цвет волос, цвет кожи и тип фотографии профиля.

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

curl --location 'https://api.numberchecker.ai/wa/api/deep/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"input.txt"'

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

curl --location 'https://api.numberchecker.ai/wa/api/deep/tasks/cs9viu7i61pkfs4oavvg' \
--header 'X-API-Key: API-KEY'

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

{
  "task_id": "cs9viu7i61pkfs4oavvg",
  "status": "pending",
  "total": 20000,
  "estimated_amount": {
    "amount": "2.000000",
    "currency": "USD"
  },
  "message": "Task created successfully. Numbers are being validated and processed in the background.",
  "created_at": "2024-10-19T18:24:56.450567423Z"
}

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

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

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

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

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

POST https://api.numberchecker.ai/wa/api/deep/tasks

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

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

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

GET https://api.numberchecker.ai/wa/api/deep/tasks/{TASK_ID}

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

Параметр	Описание
user_id	string, идентификатор пользователя

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

Поле	Описание	Пример
Number	Номер телефона в формате E.164	+41798284651
age	Предполагаемый возраст по фотографии профиля	25
avatar	URL фотографии профиля WhatsApp	https://example.com/avatar.jpg
category	Категория фотографии профиля	individual portrait, pet avatar, object, etc.
gender	Пол, определенный по фотографии профиля	male, female
hair_color	Цвет волос, определенный по фотографии профиля	black, brown, blonde, etc.
skin_color	Этническая принадлежность, определенная по фотографии профиля	white, black, etc.
whatsapp	Есть ли у номера активная учетная запись WhatsApp	yes, no

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

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

Коды статуса

Статус	Описание
200	free, запрос успешно выполнен (например, запрос статуса)
202	charge, задача успешно создана; списывается ориентировочная сумма
400	free, неверный запрос: недопустимые параметры или формат файла, неподдерживаемый тип задачи или количество корректных записей меньше минимального
401	free, отсутствует или недействителен API-ключ
402	free, недостаточно средств на балансе
404	free, задача не найдена
413	free, загруженный файл слишком большой
500	free, внутренняя ошибка сервера, повторите попытку позже