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

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

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

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

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

curl --location 'https://api.ekycpro.com/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.ekycpro.com/fb/api/simple/tasks

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

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

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

GET https://api.ekycpro.com/fb/api/simple/tasks/{TASK_ID}

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

Параметр	Описание
user_id	string, 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	charge, Успешный запрос, задача создана или статус получен
400	free, Неверный запрос, недопустимые параметры или формат файла
500	free, Внутренняя ошибка сервера, повторите попытку позже