Saltearse al contenido

Amazon API de Verificación de Emails: Verificación rápida de emails

Verifica si las direcciones de email ingresadas están registradas en Amazon

Ejemplo para subir el archivo de detección:

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

Ejemplo para consultar el estado de la tarea:

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

Respuesta cuando la carga del archivo fue exitosa:

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

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

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

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

Parámetros de solicitud para subir archivo

ParámetroDescripción
filefile, Sube un archivo; cada línea debe contener una dirección de email
task_typestring, Tipo de tarea, establecer en “amazon_email”

URL de solicitud para consultar estado

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

Parámetros de solicitud para consultar estado

ParámetroDescripción
task_idstring, ID de tarea devuelto al crear la tarea

Campos del resultado

CampoDescripciónEjemplo
EmailEmail addressuser@example.com
amazonWhether email is registered with Amazonyes, no

Formato de respuesta

FieldDescription
created_atTimestamp when task was created
updated_atTimestamp of last task status update
task_idUnique task identifier
user_idID of user
statusTask status:
pending: Queued and waiting
processing: Currently processing
exported: Results available for download
totalTotal email addresses processed
successEmails successfully verified
failureEmails that failed processing
result_url(Optional) Download URL for results when status is exported

Códigos de estado

EstadoDescripción
200charge, Request successful, task created or status retrieved
400free, Bad request, invalid parameters or file format
500free, Internal server error, retry later