Control de versiones

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

Si todavía llamas a v1, migra tu integración a v2. Todos los SDK 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.

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.

• 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