Saltearse al contenido

API de verificación de números masiva de Amazon: verificación rápida de números de teléfono

Verifique los detalles de Amazon del número global de entrada, si es una cuenta de Amazon

Ejemplo de código de archivo de detección de carga:

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

Ejemplo de código de verificación de estado de tarea:

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

Respuesta para la carga exitosa del archivo de detección

{
"task_id": "d4g8o46p2jvh04o9uolg",
"status": "pending",
"total": 2049,
"message": "Task created successfully",
"created_at": "2025-11-21T15:58:08.916446594Z"
}

Respuesta para el estado de procesamiento

{
"created_at": "2025-11-21T08:27:09.933Z",
"updated_at": "2025-11-21T08:27:10.241Z",
"task_id": "d4g24nep2jvh04o9uoh0",
"user_id": "wfi7wGPS4B4PdtTMox5Y",
"status": "processing",
"total": 2049,
"success": 1024,
"failure": 0
}

Proporcione una respuesta indicando que la tarea se completó e incluya la URL de descarga de los resultados.

{
"created_at": "2025-11-21T08:27:09.933Z",
"updated_at": "2025-11-21T08:27:10.241Z",
"task_id": "d4g24nep2jvh04o9uoh0",
"user_id": "wfi7wGPS4B4PdtTMox5Y",
"status": "exported",
"total": 2049,
"success": 2049,
"failure": 0,
"result_url": "https://wapic.s3.ap-southeast-1.amazonaws.com/externalcheck/d4g24nep2jvh04o9uoh0/d4g24nep2jvh04o9uoh0.zip?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}

URL de solicitud de carga de archivo

POST https://api.ekycpro.com/v1/tasks

Parámetros de solicitud de carga de archivo

ParámetroDescripción
filefile, Archivo de carga, cada línea debe contener un número de teléfono en formato E.164
task_typestring, Tipo de tarea, establecer en “amazon”

URL de solicitud de verificación de estado de tarea

POST https://api.ekycpro.com/v1/gettasks

Parámetros de solicitud de verificación de estado de tarea

ParámetroDescripción
task_idstring, ID de tarea devuelto en la creación de la tarea

Campos de resultado

CampoDescripciónEjemplo
NumberNúmero de teléfono en formato E.164+12025551234
amazonSi el número tiene una cuenta Amazon activasí, no

Formato de respuesta

CampoDescripción
created_atMarca de tiempo cuando se creó la tarea
updated_atMarca de tiempo de la última actualización de estado de la tarea
task_idIdentificador único de la tarea
user_idID del usuario
statusEstado de la tarea:
pending: En cola y esperando
processing: Procesando actualmente
exported: Resultados disponibles para descargar
totalTotal de números de teléfono procesados
successNúmeros identificados exitosamente
failureNúmeros que fallaron en el procesamiento
result_url(Opcional) URL de descarga de resultados cuando el estado es exported

Códigos de estado

EstadoDescripción
200charge, Solicitud exitosa, tarea creada o estado recuperado
400free, Solicitud incorrecta, parámetros o formato de archivo inválidos
500free, Error interno del servidor, intente más tarde