API Массовой Проверки Номеров Line: Быстрая Верификация Номеров Телефонов

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

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

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

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

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

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

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

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

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Предоставьте ответ, указывающий, что задача выполнена, и включите URL для загрузки результатов.

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}

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

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

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

Параметр	Описание
file	file, Загрузить файл, каждая строка должна содержать один телефонный номер в формате E.164
task_type	string, Тип задачи, установите “line”

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

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

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

Параметр	Описание
task_id	string, ID задачи, возвращенный при создании задачи

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

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

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

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

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

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