Telegram API массовой проверки номеров: быстрая проверка телефонов

Check the details of the Telegram of the input global number, whether it is a Telegram account

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

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

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

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

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

{
  "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/v1/tasks

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

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

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

POST https://api.ekycpro.com/v1/gettasks

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

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

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

Поле	Описание	Пример
Number	Phone number in E.164 format	+41798284651
telegram	Whether number has active Telegram account	yes, no

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

Field	Description
created_at	Timestamp when task was created
updated_at	Timestamp of last task status update
task_id	Unique task identifier
user_id	ID of user
status	Task status: pending: Queued and waiting processing: Currently processing exported: Results available for download
total	Total phone numbers processed
success	Numbers successfully identified
failure	Numbers that failed processing
result_url	(Optional) Download URL for results when status is exported

Коды статуса

Статус	Описание
200	charge, Request successful, task created or status retrieved
400	free, Bad request, invalid parameters or file format
500	free, Internal server error, retry later