Compatibilidad de la API

Compromiso de versionadoCopiar enlace de la sección

La API se versiona en la ruta de la URL. Hoy solo existe /v1.

• Los cambios en v1 son solo aditivos. Añadimos endpoints, campos opcionales de solicitud, campos de respuesta y tipos de evento. No eliminamos ni renombramos ningún campo, no cambiamos su significado ni convertimos un campo opcional en obligatorio. Su cliente debe ignorar los campos de respuesta que no conozca.
• Un cambio incompatible se publica como /v2. Lo anunciamos al menos 180 días antes de que esté disponible, y /v1 sigue funcionando junto a /v2 durante 180 días tras el lanzamiento de /v2.

Una copia por destinatarioCopiar enlace de la sección

Cuando POST /v1/transactional/send tiene varios destinatarios en to, cada destinatario recibe una copia independiente del mensaje, con su propio ID de mensaje. No existe un mensaje compartido ni Cc visible: ningún destinatario ve las direcciones de los demás. La solicitud no acepta cc ni bcc. Si necesita que todos los destinatarios se vean entre sí, eso no está disponible en v1.

Tamaño de los adjuntosCopiar enlace de la sección

Un mensaje lleva como máximo 10 adjuntos y como máximo 10 MiB en total, medidos tras decodificar Base64. Una solicitud que supere el límite se rechaza con 400 VALIDATION_FAILED. Consulte Adjuntos.

Alcance de la idempotenciaCopiar enlace de la sección

X-Idempotency-Key se acepta en exactamente dos endpoints: POST /v1/transactional/send y POST /v1/transactional/send-batch. Ningún otro endpoint lo lee, por lo que reintentar cualquier otro POST puede repetir su efecto. Consulte Idempotencia.