API массовой проверки номеров Facebook: Быстрая верификация телефонных номеров

Проверьте детали Facebook для введенного глобального номера, является ли он аккаунтом Facebook

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

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

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

curl --location 'https://api.checknumber.ai/fb/api/simple/tasks/cs9viu7i61pkfs4oavvg' \
--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/fb/api/simple/tasks

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

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

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

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

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

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

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

Поле	Описание	Пример
Number	Телефонный номер в формате E.164	+41798284651
facebook	Есть ли у номера активный аккаунт Facebook	yes, no, ban

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

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

Коды статуса

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