Entorno de pruebas
Una clave que empieza por sk_test_ funciona en modo de pruebas: no se hace ninguna verificación real y no se consumen créditos. Úsala para construir tu integración y en tus tests automáticos.
Veredictos predecibles
La sintaxis se sigue comprobando. Después, el veredicto lo decide la parte local de la dirección (el texto anterior a @):
| Dirección | verdict |
reason_code |
|---|---|---|
valid@… |
valid |
|
invalid@… |
invalid |
|
risky@… |
risky |
catch_all |
disposable@… |
risky |
disposable_domain |
| Cualquier otra | unknown |
El contrato solo fija el reason_code en los dos casos risky. En los demás, comprueba el verdict.
curl https://api.salchimail.com/v1/verify \
-H "Authorization: Bearer $SALCHIMAIL_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "risky@example.com", "mode": "mailbox"}'En qué se diferencia del modo real
- Los objetos llevan
"livemode": false, incluidosGET /accountyGET /usage. - No se cobran ni se reservan créditos.
- Los lotes de prueba terminan en segundos, así que puedes recorrer todo el flujo de lotes: crear, consultar y descargar.
- Nunca se contacta con el servidor de correo de la dirección.
Todo lo demás es el mismo contrato: los mismos endpoints, campos, errores y reglas de idempotencia.
Uso recomendado
- Ten una clave
sk_test_en desarrollo y en integración continua, y la clavesk_live_solo en producción. - Cubre cada rama de tu código con la dirección que le corresponde: un test con
valid@, otro coninvalid@, otro conrisky@y otro con una dirección que déunknown. - Comprueba
livemodeen tus tests para asegurarte de que nunca gastan créditos reales.