# 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.
