Esta gema Ruby ofrece integración con la API oficial para Mailtrap.
Agregue rápidamente la funcionalidad de envío de correo electrónico a su aplicación Ruby con MailTrap.
(Este cliente usa API V2, para V1, consulte esta documentación)
Agregue esta línea al archivo gem de su aplicación:
gem 'mailtrap'
Y luego ejecutar:
$ bundle install
O instálelo usted mismo como:
$ gem install mailtrap
# place this code in config/environments/production.rb:
config . action_mailer . delivery_method = :mailtrap
# then set the MAILTRAP_API_KEY environment variable
# using your hosting solution.
require 'mailtrap'
# create mail object
mail = Mailtrap :: Mail :: Base . new (
from : { email : '[email protected]' , name : 'Mailtrap Test' } ,
to : [
{ email : '[email protected]' }
] ,
subject : 'You are awesome!' ,
text : "Congrats for sending test email with Mailtrap!"
)
# create client and send
client = Mailtrap :: Client . new ( api_key : 'your-api-key' )
client . send ( mail )
Consulte la carpeta de examples
para obtener más ejemplos.
mailtrap
Gem usa la API MailTrap para enviar correos electrónicos. MailTrap API no intenta replicar SMTP. Es por eso que debe esperar algunas limitaciones cuando se trata de enviar. Por ejemplo, /api/send
endpoint ignora Content-Transfer-Encoding
(ver headers
en la documentación de la API). Lo que significa que sus destinatarios recibirán correos electrónicos solo en la codificación predeterminada que se quoted-printable
, si envía una API MailTrap.
Para aquellos que necesitan usar 7bit
o cualquier otra codificación, SMTP proporciona una mejor flexibilidad en ese sentido. Vaya a su cuenta MailTrap → Envío de correo electrónico → Sendición de dominios → Su dominio → Configuración SMTP/API para encontrar el ejemplo de configuración SMTP.
Cambiar Mailtrap::Sending::Client
a Mailtrap::Client
.
Si usa clases que han Sending
el espacio de nombres, elimine el espacio de nombres como en el ejemplo anterior.
Después de revisar el repositorio, ejecute bin/setup
para instalar dependencias. Luego, ejecute rake spec
para ejecutar las pruebas. También puede ejecutar bin/console
para un mensaje interactivo que le permitirá experimentar.
Para instalar esta gema en su máquina local, ejecute bundle exec rake install
. Para lanzar una nueva versión, actualice el número de versión en version.rb
y luego ejecute bundle exec rake release
, que creará una etiqueta GIT para la versión, Push Git Commits y la etiqueta creada, y empujará el archivo .gem
a RubyGems. org.
Los informes de errores y las solicitudes de extracción son bienvenidas en GitHub. Este proyecto pretende ser un espacio seguro y acogedor para la colaboración, y se espera que los contribuyentes se adhieran al Código de Conducta.
La gema está disponible como código abierto bajo los términos de la licencia MIT.
Se espera que todos los que interactúen en las bases de código, los rastreadores de problemas, las salas de chat y las listas de correo del proyecto MailTrap sigan el código de conducta.