Telegram Username Full API: Comprobación masiva

Telegram Username Full: Procese los valores de entrada mediante la API por lotes y obtenga los campos de resultado que se indican a continuación.

Formato de entrada

Cargue un archivo de texto con un nombre de usuario por línea. Normalice los valores antes de cargarlo.

@example_user
@another_user

Crear una tarea

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"'

La API devuelve un ID de tarea. Guárdelo y úselo para consultar el estado.

Respuesta de carga

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

Comprobar el estado de la tarea

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"'

Consulte hasta que status sea exported. No considere pending ni processing como resultados completos.

Respuesta en proceso

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

Respuesta exportada

{
  "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"
  }
}

Campos del resultado

Campo	Descripción	Ejemplo
username	Nombre de usuario de entrada del archivo enviado.	example_user
activated	Indica si la entrada se detectó como activa o registrada.	yes
nickname	Campo de resultado devuelto: nickname.	valor de ejemplo
avatar	Campo de resultado devuelto: avatar.	valor de ejemplo
gender	Campo de resultado devuelto: gender.	valor de ejemplo
age	Campo de resultado devuelto: age.	valor de ejemplo
skin_color	Campo de resultado devuelto: skin_color.	valor de ejemplo
user_id	Campo de resultado devuelto: user_id.	valor de ejemplo
active_days	Campo de resultado devuelto: active_days.	valor de ejemplo
is_vip	Campo de resultado devuelto: is_vip.	valor de ejemplo
is_frozen	Campo de resultado devuelto: is_frozen.	valor de ejemplo

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

Procesamiento del archivo de resultados

Descargue el archivo desde result_url solo después de exportar la tarea. Conserve los nombres de columna devueltos al procesar el archivo.

Campos de respuesta

Campo	Descripción
created_at	Marca de tiempo de creación de la tarea.
updated_at	Marca de tiempo de la última actualización.
task_id	Identificador único de la tarea.
status	pending, processing, exported o failed.
total	Total de valores de entrada procesados.
success	Valores procesados correctamente.
failure	Valores cuyo procesamiento falló.
result_url	URL de descarga cuando la tarea se exporta.
actual_amount	Importe final liquidado, si está disponible.
estimated_amount	Importe estimado devuelto al crear la tarea.

Códigos de estado

Status	Descripción
200	Solicitud correcta.
202	Tarea creada correctamente y cargo estimado aplicado.
400	Archivo no válido, tipo de tarea no compatible o muy pocas entradas válidas.
401	Falta la clave API o no es válida.
402	Saldo insuficiente.
404	Tarea no encontrada.
413	El archivo cargado es demasiado grande.
500	Error interno del servidor; inténtelo más tarde.

Notas operativas

• La tarea es asíncrona; use el ID para consultar su estado.
• Compruebe los límites de entrada del producto antes de cargar el archivo.
• Las filas fallidas aparecen en el resultado exportado y se reflejan en los contadores.
• Los campos anteriores se basan en el sample actual y pueden cambiar si cambia el esquema de exportación.