Pigeon

A Comms Micro Service

Abstract

Provides end points for sending communication such as Email

Prerequisite

dep ensure

Usage

export DOMAIN="mailgun domain"
export API_KEY="mailgun api key"
export PUBLIC_API_KEY="mailgun api public key"
export TEMPLATES="templates"
export TO_EMAIL="[email protected]"

Enable test mode

export TEST_MODE=1

Set api url to eu region

export MG_URL=https://api.eu.mailgun.net/v3

Send an email

curl -X POST http://localhost:3411/email \
-d "{
        \"to\":\"[email protected]\",
        \"from\":\"[email protected]\",
        \"subject\":\"Cool Subject\",
        \"text\":\"Interesting Message\"
    }"

Use a template

curl -X POST http://localhost:3411/email \
-d "{
        \"to\": \"[email protected]\",
        \"from\": \"[email protected]\",
        \"template\": \"test\",
        \"params\": {
            \"name\": \"Cuthbert\",
            \"colour\": \"Purple\"
        }
    }"

Get a template

curl -X POST http://localhost:3411/template \
-d "{
        \"template\": \"test\",
        \"params\": {
            \"name\": \"Cuthbert\",
            \"colour\": \"Purple\"
        }
    }"

Verify Email

curl -X POST http://localhost:3411/verify \
-d "{
        \"email\": \"[email protected]\",
        \"ip\": \"127.0.0.1\"
    }"

Upgrading Packages

Upgrade packages by specifying the package to upgrade.

go get -u github.com/aws/aws-sdk-go