API de Verificación Masiva de Números de Facebook: Verificación Rápida de Números de Teléfono

Verifica los detalles de Facebook del número global de entrada, si es una cuenta de Facebook

Ejemplo de código para cargar archivo de detección:

curl --location 'https://api.checknumber.ai/fb/api/simple/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"input.txt"'

Ejemplo de código para verificar estado de tarea:

curl --location 'https://api.checknumber.ai/fb/api/simple/tasks/cs9viu7i61pkfs4oavvg' \
--header 'X-API-Key: API-KEY'

Respuesta para la carga exitosa del archivo de detección

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

Proporciona una respuesta indicando que la tarea está completada e incluye la URL de descarga de los resultados.

{
  "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 cargar archivo

POST https://api.checknumber.ai/fb/api/simple/tasks

Parámetros de solicitud para cargar archivo

Parámetro	Descripción
user_id	string, ID de usuario
file	archivo, Cargar archivo, cada línea debe contener un número de teléfono en formato E.164

URL de solicitud para verificar estado de tarea

GET https://api.checknumber.ai/fb/api/simple/tasks/{TASK_ID}

Parámetros de solicitud para verificar estado de tarea

Parámetro	Descripción
user_id	string, ID de usuario

Campos de Resultado

Campo	Descripción	Ejemplo
Number	Número de teléfono en formato E.164	+41798284651
facebook	Si el número tiene cuenta activa de Facebook	yes, no, ban

Formato de Respuesta

Campo	Descripción
created_at	Marca de tiempo cuando se creó 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 esperando processing: Procesando actualmente completed: Procesamiento finalizado exported: Resultados disponibles para descarga
total	Total de números de teléfono procesados
success	Números identificados exitosamente
failure	Números que fallaron en el procesamiento
result_url	(Opcional) URL de descarga de resultados cuando el estado es exported

Códigos de Estado

Estado	Descripción
200	con costo, Solicitud exitosa, tarea creada o estado recuperado
400	gratis, Solicitud incorrecta, parámetros inválidos o formato de archivo
500	gratis, Error interno del servidor, inténtelo más tarde