Sideline Number API: Comprobación masiva

Sideline Number: 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 número de teléfono por línea. Normalice los valores antes de cargarlo; se recomienda el formato E.164 para teléfonos.

+14155552671
+442071838750

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

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
Number	Número de teléfono de la entrada enviada.	+14155552671
activated	Indica si la entrada se detectó como activa o registrada.	yes

Note: Confirmed from the current product sample; fields are Number and activated.

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.