Apple API de Verificación Masiva de Números: Verificación rápida

Comprueba si el número global ingresado está asociado a una cuenta de Apple

Ejemplo para subir el archivo de detección:

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

Ejemplo para consultar el estado de la tarea:

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

Respuesta cuando la carga del archivo fue exitosa:

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

Respuesta para el estado de procesamiento:

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

Respuesta cuando la tarea está completada (incluye la URL de descarga):

{
  "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 de solicitud para subir archivo

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

Parámetros de solicitud para subir archivo

Parámetro	Descripción
file	file, Sube un archivo; cada línea debe contener un número en formato E.164
task_type	string, Tipo de tarea, establecer en “apple”

URL de solicitud para consultar estado

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

Parámetros de solicitud para consultar estado

Parámetro	Descripción
task_id	string, ID de tarea devuelto al crear la tarea

Campos del resultado

Campo	Descripción	Ejemplo
Number	Número de teléfono en formato E.164	+41798284651
apple	Indica si el número tiene una cuenta activa de Apple	sí, no

Formato 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 del estado de la tarea
task_id	Identificador único de la tarea
user_id	ID del usuario
status	Estado de la tarea: pending: En cola y en espera processing: En procesamiento exported: Resultados disponibles para descargar
total	Total de números de teléfono procesados
success	Números identificados correctamente
failure	Números cuyo procesamiento falló
result_url	(Opcional) URL de descarga de los resultados cuando el estado es exported

Códigos de estado

Estado	Descripción
200	charge, Solicitud correcta; tarea creada o estado obtenido
400	free, Solicitud incorrecta; parámetros o formato de archivo no válidos
500	free, Error interno del servidor; inténtelo más tarde