Inicio rápido
Crea una clave API en el panel, guárdala en tu servidor y envíala como credencial Bearer. Cada solicitud de verificación aceptada consume un crédito.
curl -sS -X POST 'https://api.verifyemail.net/api/v1/verifications' \
-H 'Authorization: Bearer ve_live_your_api_key' \
-H 'Content-Type: application/json' \
-d '{"address":"[email protected]"}'{
"errcode": 0,
"address": "[email protected]",
"is_deliverable": true,
"status": 250,
"catch_all": false,
"disposable": false
}Autenticación
Crea una clave API en tu panel: Panel → Claves API
El valor completo ve_live_… solo se muestra una vez.
Verificar un correo
/verificationsCuerpo de la solicitud
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| address | string | Sí | Una dirección de correo completa. |
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
| errcode | number | 0 indica éxito; gestiona los demás valores con la tabla de errores. |
| address | string | La dirección de correo normalizada. |
| is_deliverable | boolean | Indica si el servidor receptor acepta al destinatario. |
| status | number | null | El código numérico de respuesta SMTP, o null si no se recibió una respuesta SMTP. |
| catch_all | boolean | null | Indica si el dominio acepta cualquier destinatario. Null significa que no hay una conclusión fiable. |
| disposable | boolean | Indica si la dirección pertenece a un dominio de correo temporal. |
250 · HTTP 200 · errcode 0
El servidor receptor aceptó al destinatario.
550 · HTTP 200 · errcode 0
El dominio o el servidor receptor rechazó al destinatario.
null · HTTP 422
La dirección no es válida o no puede verificarse.
null · HTTP 503
No hay una conclusión fiable; inténtalo más tarde.
También está disponible el siguiente endpoint GET. Se recomienda POST para evitar que las direcciones aparezcan en registros del proxy o en el historial del navegador: /verifications?address=…
Consultar créditos restantes
/usageEsta solicitud no consume créditos de verificación. Las sesiones del panel y todas las claves API del mismo usuario comparten un único saldo.
curl -sS 'https://api.verifyemail.net/api/v1/usage' \
-H 'Authorization: Bearer ve_live_your_api_key'{
"errcode": 0,
"verification_limit": 100,
"verification_used": 1,
"remaining_verifications": 99,
"unlimited": false
}| Campo | Tipo | Descripción |
|---|---|---|
| verification_limit | number | El límite total actual. Cero significa ilimitado. |
| verification_used | number | El número de créditos de verificación utilizados. |
| remaining_verifications | number | null | Créditos disponibles; null cuando la cuenta es ilimitada. |
| unlimited | boolean | Indica si el saldo actual es ilimitado. |
Los planes ilimitados devuelven remaining_verifications: null, unlimited: true.
Códigos de error
Usa el número errcode para la lógica del programa. El texto message puede cambiar.
{
"errcode": 10006,
"message": "request rate limit exceeded"
}| errcode | HTTP | Significado |
|---|---|---|
| 0 | 2xx | Solicitud correcta. |
| 10000 | 400 | Solicitud mal formada; revisa el JSON, las cabeceras y el método HTTP. |
| 10001 | 400 / 422 | Un parámetro o una regla de negocio no superó la validación. |
| 10002 | 401 | La credencial falta, no es válida o ha caducado. |
| 10003 | 403 | La cuenta no puede acceder a este recurso. |
| 10004 | 404 | El recurso solicitado no existe. |
| 10005 | 409 | El recurso entra en conflicto con el estado actual. |
| 10006 | 429 | Se superó el límite de solicitudes por segundo. |
| 10007 | 429 | Se agotaron los créditos de verificación. |
| 10008 | 429 | Se agotó la capacidad concurrente del servicio. |
| 10009 | 500 | Se produjo un error interno del servicio. |
| 10010 | 503 | El servicio no está disponible temporalmente o no está configurado. |
| 10011 | 502 | Un servicio externo devolvió un error. |
Cabeceras de límite
Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset — describen la ventana de solicitudes actual.