Changelog

Cómo se versiona la API

La versión forma parte de la URL: https://api.salchimail.com/v1.

Dentro de v1, los cambios son aditivos. Estos pueden ocurrir sin cambiar de versión, así que escribe tu integración para tolerarlos:

  • Endpoints nuevos, campos opcionales nuevos en las peticiones y campos nuevos en las respuestas.
  • Valores nuevos de reason_code y del code de error. Trata un valor que no conozcas según su verdict o su type de error.
  • Tipos nuevos de evento de webhook.

Eliminar o renombrar un campo, cambiar su tipo o cambiar el significado de un veredicto sería un cambio incompatible y se publicaría como una versión nueva.

2026-11-17 · API v1.0.0

Primera versión del contrato de la API pública.

  • POST /verify: verifica una dirección en modo basic o mailbox.
  • POST /batches, GET /batches, GET /batches/{batch_id}, GET /batches/{batch_id}/results y POST /batches/{batch_id}/cancel: verifica listas desde JSON o CSV y descarga los resultados en JSON o CSV.
  • GET /usage y GET /account: créditos, uso, plan y límites.
  • Webhooks batch.completed y credits.low, firmados con HMAC-SHA256.
  • Idempotency-Key en todos los POST, modo de pruebas con claves sk_test_ y un único formato de error para toda la API.

Ver esta página en Markdown