Skip to content

πŸ“© An API that forwards HTTP-backed vendor mailer calls to an SMTP catcher

License

Notifications You must be signed in to change notification settings

eexit/http2smtp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

3e1010b Β· Jan 4, 2021

History

46 Commits
Jan 4, 2021
Jan 3, 2021
Jan 4, 2021
Jan 4, 2021
Dec 31, 2020
Dec 29, 2020
Jan 4, 2021
Dec 29, 2020
Jan 4, 2021
Jan 4, 2021
Dec 31, 2020
Jan 4, 2021
Jan 3, 2021
Dec 31, 2020
Jan 4, 2021
Jan 4, 2021
Jan 3, 2021
Jan 3, 2021
Dec 31, 2020

Repository files navigation

πŸ“© HTTP to SMTP

version docker pull ci codecov license

An API proxies HTTP-backed vendor mailer calls to SMTP.

Plug a MailHog or MailCatcher to API email sending vendors such as SparkPost, MailGun or Twilio SendGrid for testing purposes.

Usage

See examples.

⚑ ProTip: for tracing purposes, this app kinda supports W3C Trace Context recommendation. Configure the env var TRACEPARENT_HEADER and inject any trace into this header value. All log entries will be contextualized with the given value.

Docker image

  1. Checkout this repo or only copy the .env.dist and docker-compose.yml files
  2. Rename .env.dist into .env
  3. Update the values accordingly
  4. Pull images and run docker-compose up http2smtp

Vendor endpoints

Inline transmission

API documentation: https://developers.sparkpost.com/api/transmissions/#transmissions-post-send-inline-content

⚠️ Not supported yet.

RFC 822 transmission

API documentation: https://developers.sparkpost.com/api/transmissions/#transmissions-post-send-rfc822-content

POST /sparkpost/api/v1/transmissions

Basic validation is enforced, only the recipients list email and the RFC 822 content are used and mandatory.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributors

contributors