# Control de versiones

> La API de Emailit está en la versión 2. Cómo se indica la versión, qué cambia sin una nueva versión, la API v1 obsoleta y el paso a los ID de objeto con prefijo.

La versión de la API forma parte de la URL base, así que cada petición indica la versión para la que se escribió. Esta página explica qué versiones existen, qué puede cambiar dentro de una versión y cómo cambiaron los ID de objeto en 2026.

## Versiones

| Versión | URL base | Estado |
| --- | --- | --- |
| v2 | `https://api.emailit.com/v2` | Actual. Publicada en octubre de 2025. Todo lo que aparece en esta referencia es v2. |
| v1 | `https://api.emailit.com/v1` | Obsoleta. La generación anterior de la API. No recibe nuevas funciones y ya no está documentada. |

Si todavía llamas a v1, migra tu integración a v2. Todos los [SDK](/es/docs/sdks/) usan v2.

## Cambios dentro de v2

Emailit amplía v2 sin cambiar la versión de la URL. Estos cambios pueden producirse en cualquier momento:

- Nuevos endpoints y recursos.
- Nuevos parámetros de petición y cabeceras opcionales.
- Nuevos campos en los objetos de respuesta y en los payloads de los webhooks.
- Nuevos tipos de eventos, estados y otros valores de enumeración.

Escribe clientes que los toleren: ignora los campos de respuesta que no reconozcas, no falles ante un estado o un tipo de evento desconocido y no dependas del orden de los campos en un objeto JSON.

Los cambios de la API se anuncian en el [registro de cambios](/es/docs/changelog/).

## ID de objeto

En enero de 2026, todos los objetos pasaron a usar ID con prefijo: un prefijo de tipo seguido de 27 letras y dígitos, como `em_4KYof1ZzXndZE2VPi0DgULiekG8` para un email o `dom_4K468YrjOkR1wwdhqiO0G9XEUey` para un dominio. Todos los endpoints aceptan y devuelven estos ID. Para ver todos los prefijos, consulta [ID de objeto](/es/docs/api-reference/#object-ids).

- Guarda los ID como cadenas y compáralos de forma exacta. Distinguen entre mayúsculas y minúsculas.
- Los dominios de envío que existían antes del cambio conservan ID que empiezan por `sd_` o `sed_`. Funcionan en cualquier lugar donde funciona un ID `dom_`, así que no valides los ID de dominio por su prefijo.
- Las claves de API son secretos, no ID. Las claves nuevas empiezan por `secret_`, y las claves antiguas sin prefijo siguen funcionando. El ID de una clave de API empieza por `key_`.

## Ver también

  - [Registro de cambios](/es/docs/changelog/): Nuevas funciones y cambios, de más reciente a más antiguo.
  - [Referencia de la API](/es/docs/api-reference/): URL base, autenticación y recursos.

---
Fuente: https://emailit.com/es/docs/api-reference/versioning/