Send API 3.1 ya está aquí

Entonces, ¿por qué crear una nueva versión?

Pues la verdad es que, aunque nos encanta sentirnos auténticos hackers, todos los desarrolladores estarán de acuerdo con que es mejor trabajar sin sufrir. Sabemos que las llamadas API son difíciles de digerir, sobre todo combinadas con poco (o nada) de documentación y comportamientos erráticos, entradas difusas, cargas de respuesta, etc.

Así que, para que la vida les resultara más fácil y el trabajo menos tedioso, decidimos centrarnos en proporcionar a nuestros usuarios una experiencia sin turbulencias a bordo de Send API. Ponemos a tu disposición una documentación muy completa, elaborada por desarrolladores para desarrolladores, así como cargas significativas para que la experiencia sea de lo más placentera.

Y para que esta nueva versión sea un pelín más avanzada y se centre de verdad en el rendimiento y la escalabilidad, decidimos reconstruirla desde cero y pasar de nuestro código anterior en Free Pascal a un sistema basado en lenguaje Go, Cassandra y Kafka, entre otros. ¿Suena bien, no?

¡Genial! ¿Y el código?

Lo primero que te llamará la atención es lo mucho que ha mejorado la experiencia del usuario en esta nueva versión. ¿Quieres verla en acción? Échale un vistazo aquí.

Envío de mensajes

Si envías uno o más mensajes, bastará con que realices una única solitud HTTP en el endpoint /v3.1/send. Send API aceptará una carga JSON con una única propiedad matriz Messages que contenga hasta 100 mensajes. Blanco y en botella, ¿no?

Aquí encontrarás una lista exhaustiva de las propiedades obligatorias y opcionales para cada mensaje.

Nuevos errores detallados y cargas de éxito

Los comentarios de nuestra comunidad nos abrieron los ojos: necesitábamos cambiar radicalmente nuestras cargas de respuesta. Ahora efectuamos rigurosos controles de todas las cargas de entrada para enviarte información simultánea sobre los fallos y reducir el tiempo que dedicas a solucionar errores. Esto supone que en tu sistema entrará únicamente un número limitado de emails mal creados. Aquí te dejamos un ejemplo de una carga de error.

Cabe destacar que estos errores se generan independientemente para cada mensaje y que únicamente se bloqueará el proceso de envío de mensajes fallidos.

Además, nuestros informes de éxito presentan más información que antes. Las cargas de éxito generan, por ejemplo, una propiedad MessageHref, una URL que remite al endpoint de la API en el que obtener los metadatos del mensaje. Seguir tus emails nada más enviarlos nunca ha sido tan fácil.

Las cargas de error y de éxito se transmiten de manera conjunta, en el mismo orden seguidas de los mensajes de carga de entrada, para que puedas comprobar el estado (fallido o válido) de tus mensajes más cómodamente.

Modo sandbox

Enviar emails de desarrollo tiene un precio (sí, cuentan en la cuota de emails de tu plan) y nunca tendrás la seguridad absoluta de que no entregas emails no deseados a tus clientes. Si estás jugueteando con la API por primera vez o comprobando tu código, quizás quieras comprobar la carga útil de un email si tener que enviarlo.

Para que tu vida de desarrollador no sea una pesadilla, hemos incorporado un modo sandbox nuevecito. En tu carga de entrada, configura SandboxMode en true. Así, Send API sabrá que debe procesar tus mensajes como si quisieras enviarlos, pero sin hacerlo de verdad, para que puedas probarlos e identificar posibles problemas.

Etiquetado de las URL

Enviar emails de manera rápida a escala forma parte de tu negocio, pero poder controlar su rendimiento es fundamental. Nuestra misión es ofrecerte todas las herramientas que necesitas para conseguirlo. Gracias a Send API v3.1, puedes indicarnos los marcadores de seguimiento adecuados y nos aseguraremos de que todos los enlaces de tus emails contienen las etiquetas y la ruta correctas.

¡Pruébalo en directo!

Si ya has usado la API de Mailjet, sabrás que nos encanta que nuestros documentos sean completitos. La experiencia del usuario no sería igual de satisfactoria sin una documentación exhaustiva para que los desarrolladores pudieran sacar partido de la nueva Send API 3.1. Por este motivo, para que domines y le saques todo el jugo a la nueva versión, esta viene acompañada de unas guías de API bien detalladas, snippets de código de Passport totalmente actualizados y asistencia en todos nuestros wrappers.

¡Y todo, gracias a vosotros!

Pues sí, porque sin nuestra estupenda comunidad de desarrolladores y su inestimable ayuda habría sido imposible presentar una joya como Send API 3.1. Todos acudisteis a nuestra llamada cuando anunciamos la beta y vuestros comentarios e implicación superaron nuestras expectativas.

Gracias a nuestra comunidad hemos podido crear un producto final mucho más avanzado que su versión original, con mejoras significativas en aspectos como los informes de errores. ¡Muchísimas gracias! ¡Sois la bomba!

¿No ves el momento de probar la nueva Send API 3.1? Consulta nuestra documentación para empezar cuanto antes. ¡Sabemos que te entusiasmará tanto como a nosotros!

¿Usas con frecuencia Send API 3.0? Aunque te recomendamos que cambies a la versión 3.1 (sería una pena que te perdieras todas sus funcionalidades), mantendremos la versión 3.0 mientras sea necesario, así que no te preocupes. Aquí encontrarás toda la información sobre la migración. Si necesitas consultar algo sobre la versión 3, todos los documentos siguen aquí.

Descubre cómo Mailjet puede mejorar tu experiencia como desarrollador en Mailjet for Developers, y suscríbete a nuestra newsletter exclusiva para desarrolladores si quieres recibir todas nuestras novedades antes que nadie. ¿Te apetece que hablemos? ¡Mándanos un tuit a @mailjetdev!