API массовой проверки бизнес-аккаунтов WhatsApp: быстрая проверка бизнес-аккаунтов

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

Пример кода загрузки файла обнаружения:

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

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

curl --location 'https://api.checknumber.ai/netflix/api/simple/tasks/cs9viu7i61pkfs4oavvg?user_id=USER_ID' \
--header 'X-API-Key: API-KEY'

Ответ на успешную загрузку файла обнаружения

{
  "created_at": "2024-10-19T18:24:56.450567423Z",
  "updated_at": "2024-10-19T18:24:56.450567423Z",
  "task_id": "cs9viu7i61pkfs4oavvg",
  "user_id": "test",
  "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",
  "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"
}

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

POST https://api.checknumber.ai/netflix/api/simple/tasks

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

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

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

GET https://api.checknumber.ai/netflix/api/simple/tasks/{TASK_ID}

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

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

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

Поле	Описание	Пример
`Number`	Номер телефона в формате E.164	+41798284651
`whatsapp_business`	Есть ли у номера активный бизнес-аккаунт WhatsApp	yes, no

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

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

Коды состояния

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