qualification que indica el resultado de una búsqueda o verificación. Esta página enumera todos los códigos y valores de calificación para que puedas gestionar las respuestas de forma fiable. Para los mensajes de error correspondientes y los formatos de respuesta, consulta Gestión de errores.
¿Qué códigos de estado HTTP devuelve la API?
La API de Enrow utiliza códigos de estado HTTP estándar para indicar el resultado de cada solicitud. Un código2xx significa que la solicitud se realizó correctamente, un código 4xx indica un problema con la solicitud y un código 5xx significa que algo salió mal por parte de Enrow.
¿Qué códigos indican éxito?
Un código de estado2xx significa que la API aceptó la solicitud. Las operaciones asíncronas (como las búsquedas masivas) devuelven 201 o 202 porque el trabajo continúa en segundo plano.
| Código | Significado | Descripción |
|---|---|---|
| 200 | OK | La solicitud se realizó correctamente, se devolvieron resultados |
| 201 | Created | Recurso creado (p. ej., búsqueda masiva iniciada) |
| 202 | Accepted | Solicitud aceptada, procesamiento asíncrono |
¿Qué códigos indican que la solicitud fue rechazada?
Un código de estado4xx significa que la API rechazó la solicitud debido a algo que se puede corregir en el lado del cliente: parámetros no válidos, una clave de API ausente o no válida, créditos insuficientes o demasiadas solicitudes.
| Código | Significado | Descripción |
|---|---|---|
| 400 | Bad Request | Parámetros no válidos o ausentes |
| 401 | Unauthorized | Clave de API no válida o ausente |
| 402 | Payment Required | Créditos insuficientes |
| 429 | Too Many Requests | Se superó el límite de frecuencia |
401 significa que la clave de API está ausente o no es válida; consulta Autenticación para saber cómo enviarla correctamente. Un 402 significa que la cuenta se ha quedado sin créditos; revisa el consumo en Créditos y facturación. Un 429 significa que la solicitud superó el rendimiento permitido; consulta Límites de frecuencia para entender los umbrales.
La API nunca devuelve 404. Un ID de búsqueda desconocido o caducado devuelve 400 para los endpoints masivos y 500 para los endpoints individuales.
¿Qué códigos indican un error del servidor?
Un código de estado5xx significa que la solicitud era válida, pero algo salió mal por parte de Enrow. Estas respuestas se pueden reintentar de forma segura tras un breve retraso.
| Código | Significado | Descripción |
|---|---|---|
| 500 | Internal Server Error | Algo salió mal de nuestro lado |
¿Qué son las calificaciones de búsqueda?
Una calificación de búsqueda es el valor del campoqualification que indica el resultado de una búsqueda o verificación. Enrow devuelve este campo en todos los endpoints, y el resultado siempre es binario: no hay un “quizás” ni una puntuación de probabilidad. Es una decisión de diseño deliberada.
¿Por qué el resultado es binario?
El resultado es binario porque una respuesta clara de sí o no es más fácil de gestionar que una probabilidad. La mayoría de las herramientas de enriquecimiento devuelven un conjunto complejo de categorías (catch-all, riesgoso, desconocido, no verificable, etc.) que te obligan a construir lógica en torno a probabilidades. Enrow adoptó el enfoque opuesto:- Enrow verifica incluso los correos catch-all de forma determinista, por lo que no es necesaria una categoría “catch-all”
- Enrow no cree en sistemas probabilísticos con docenas de clasificaciones: añaden complejidad sin aportar claridad
- Un resultado binario significa que puedes actuar sobre los datos de inmediato sin tener que dudar
¿Qué calificaciones devuelve Email Finder?
El Email Finder devuelve uno de los siguientes valores en el campoqualification:
| Calificación | Significado |
|---|---|
valid | Correo encontrado y verificado |
invalid | Correo no encontrado |
ongoing | Búsqueda aún en curso |
¿Qué calificaciones devuelve Email Verifier?
El Email Verifier devuelve uno de los siguientes valores en el campoqualification:
| Calificación | Significado |
|---|---|
valid | El correo es válido y entregable |
invalid | El correo es inválido o no entregable |
ongoing | Verificación aún en curso |
invalid significa cosas distintas según el endpoint: en el Email Finder, significa que el correo no se encontró. En el Email Verifier, significa que el correo existe pero no es entregable.¿Qué calificaciones devuelve Phone Finder?
El Phone Finder devuelve uno de los siguientes valores en el campoqualification:
| Calificación | Significado |
|---|---|
found | Número de teléfono localizado correctamente |
not_found | No se pudo encontrar el número de teléfono |
ongoing | Búsqueda aún en curso |
¿Cómo hago el seguimiento de una búsqueda masiva?
Para las operaciones masivas, un campostatus indica el progreso del lote. Sondea el endpoint GET correspondiente (resultados masivos de Email Finder, verificaciones masivas de Email Verifier o resultados masivos de Phone Finder) hasta que el status sea completed.
| Estado | Significado |
|---|---|
ongoing | El lote sigue procesándose |
completed | Todas las búsquedas del lote han finalizado |
failed | El lote falló |
FAQ
¿Por qué obtengo un 401 en lugar de un 200?
¿Por qué obtengo un 401 en lugar de un 200?
Un
401 Unauthorized significa que la clave de API está ausente o no es válida. Asegúrate de que cada solicitud incluya una clave válida en la cabecera x-api-key. Consulta Autenticación para más detalles.¿Qué significa un código de estado 402?
¿Qué significa un código de estado 402?
Un
402 Payment Required significa que la cuenta no tiene créditos suficientes para completar la solicitud. Recarga o revisa cómo se consumen los créditos por endpoint en Créditos y facturación.¿Por qué un ID de búsqueda desconocido devuelve 400 o 500 en lugar de 404?
¿Por qué un ID de búsqueda desconocido devuelve 400 o 500 en lugar de 404?
La API de Enrow nunca devuelve
404. Un ID de búsqueda desconocido o caducado devuelve 400 para los endpoints masivos y 500 para los endpoints individuales. Vuelve a comprobar el id devuelto cuando se inició la búsqueda.¿qualification: ongoing significa que algo falló?
¿qualification: ongoing significa que algo falló?
No.
ongoing significa que la búsqueda o verificación aún está en curso. Vuelve a sondear el endpoint GET tras un breve retraso, o usa un webhook para recibir una notificación automática cuando finalice; consulta Cómo funcionan los webhooks.Próximos pasos
Gestión de errores
Consulta los mensajes de error completos y los formatos de respuesta para cada código de estado.
Autenticación
Envía tu clave de API en la cabecera x-api-key para evitar errores 401.
Límites de frecuencia
Comprende los umbrales que activan una respuesta 429.
Créditos y facturación
Consulta cómo se consumen los créditos y evita errores 402.