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.

Shell
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, incluidos GET /account y GET /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 clave sk_live_ solo en producción.
  • Cubre cada rama de tu código con la dirección que le corresponde: un test con valid@, otro con invalid@, otro con risky@ y otro con una dirección que dé unknown.
  • Comprueba livemode en tus tests para asegurarte de que nunca gastan créditos reales.

Ver esta página en Markdown