Telegram Username Full API: пакетная проверка

Telegram Username Full: Обрабатывайте входные значения через пакетный API и получайте перечисленные ниже поля результата.

Формат входных данных

Загрузите текстовый файл, по одному имени пользователя в строке. Нормализуйте значения перед загрузкой.

@example_user
@another_user

Создание задачи

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

curl --location 'https://api.numberchecker.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./input.txt"' \
--form 'task_type="tg_username_full"'

API возвращает ID задачи. Сохраните его и используйте для проверки статуса.

Ответ при загрузке

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 5000,
  "estimated_amount": {
    "amount": "0.500000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

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

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

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

Проверяйте статус, пока status не станет exported. Значения pending и processing не означают завершение.

Ответ при обработке

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 5000,
  "success": 2500,
  "failure": 0
}

Экспортированный ответ

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 5000,
  "success": 5000,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "2.000000",
    "currency": "USD"
  }
}

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

Поле	Описание	Пример
username	Имя пользователя из переданного файла.	example_user
activated	Показывает, был ли вход активным или зарегистрированным.	yes
nickname	Возвращаемое поле результата: nickname.	пример значения
avatar	Возвращаемое поле результата: avatar.	пример значения
gender	Возвращаемое поле результата: gender.	пример значения
age	Возвращаемое поле результата: age.	пример значения
skin_color	Возвращаемое поле результата: skin_color.	пример значения
user_id	Возвращаемое поле результата: user_id.	пример значения
active_days	Возвращаемое поле результата: active_days.	пример значения
is_vip	Возвращаемое поле результата: is_vip.	пример значения
is_frozen	Возвращаемое поле результата: is_frozen.	пример значения

Note: Verified against live sample; full profile, activity, VIP, and frozen fields are now confirmed.

Обработка файла результата

Скачивайте файл по result_url только после экспорта задачи. Сохраняйте имена возвращённых столбцов при дальнейшей обработке.

Поля ответа

Поле	Описание
created_at	Время создания задачи.
updated_at	Время последнего обновления статуса.
task_id	Уникальный идентификатор задачи.
status	pending, processing, exported или failed.
total	Общее число обработанных входных значений.
success	Успешно обработанные значения.
failure	Значения, обработка которых завершилась ошибкой.
result_url	URL для скачивания после экспорта задачи.
actual_amount	Итоговая сумма, если доступна.
estimated_amount	Расчётная сумма, возвращаемая при создании задачи.

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

Status	Описание
200	Запрос выполнен успешно.
202	Задача создана успешно, применена предварительная стоимость.
400	Недопустимый файл, неподдерживаемый тип задачи или слишком мало корректных записей.
401	API-ключ отсутствует или недействителен.
402	Недостаточно средств на счёте.
404	Задача не найдена.
413	Загруженный файл слишком велик.
500	Внутренняя ошибка сервера; повторите попытку позже.

Рабочие примечания

• Задача выполняется асинхронно; используйте ID задачи для проверки статуса.
• Перед загрузкой проверьте ограничения продукта на входные данные.
• Ошибочные строки указаны в экспортированном результате и отражены в счётчиках задачи.
• Поля выше основаны на текущем live sample и могут измениться при изменении схемы экспорта.