Create /api/send HTTP POST Endpoint for Auth to Call

[nelsonic]

The goal of having a separate email service dwyl/auth#39 is to simplify sending email as much as possible.
At present it is relatively easy to send an email via the aws-ses-lambda function, but it requires quite a few steps of setup and 3 AWS environment variables. We don't want anyone contributing to the App to have to follow those steps in order to get the App running on their localhost. We want them to be able to use a single DWYL_API_KEY environment variable which connects them to the auth and email services.

• receive payload data:
  • email
  • name
  • template
• JWT

In the context of the diagram below, we are building Step 3:

From the perspective of the App, it doesn't (ever need to) know about the Email service.
Everything Email related happens in the background.

[nelsonic]

Valid JWT:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJKb2tlbiIsImVtYWlsIjoic3VjY2Vzc0BzaW11bGF0b3IuYW1hem9uc2VzLmNvbSIsImV4cCI6MTU4NTI1MzU2MiwiaWF0IjoxNTg1MjQ2MzYyLCJpc3MiOiJKb2tlbiIsImp0aSI6IjJudnVxYW5kbjdhNjFwbTdsczAwMDBxMSIsIm5hbWUiOiJTdXBlciBTdWNjZXNzZnVsIiwibmJmIjoxNTg1MjQ2MzYyLCJ0ZW1wbGF0ZSI6IndlbGNvbWUifQ.rZeABtUwYLGeXopq04gI0VfRBgBUjQQKjAnSG1hs8sQ

Curl Request localhost:

curl -X POST "http://localhost:4000/api/send"\
  -H "Content-Type: application/json"\
  -H "authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJKb2tlbiIsImVtYWlsIjoic3VjY2Vzc0BzaW11bGF0b3IuYW1hem9uc2VzLmNvbSIsImV4cCI6MTU4NTI1MzU2MiwiaWF0IjoxNTg1MjQ2MzYyLCJpc3MiOiJKb2tlbiIsImp0aSI6IjJudnVxYW5kbjdhNjFwbTdsczAwMDBxMSIsIm5hbWUiOiJTdXBlciBTdWNjZXNzZnVsIiwibmJmIjoxNTg1MjQ2MzYyLCJ0ZW1wbGF0ZSI6IndlbGNvbWUifQ.rZeABtUwYLGeXopq04gI0VfRBgBUjQQKjAnSG1hs8sQ"

Expect to see the following response:

{
  "aud": "Joken",
  "email": "[email protected]",
  "exp": 1585253562,
  "iat": 1585246362,
  "id": 120,
  "iss": "Joken",
  "jti": "2nvuqandn7a61pm7ls0000q1",
  "name": "Super Successful",
  "nbf": 1585246362,
  "status": "Pending",
  "template": "welcome"
}

[nelsonic]

Test it on Heroku:

curl -X POST "https://dwylmail.herokuapp.com/api/send"\
  -H "Content-Type: application/json"\
  -H "authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhdWQiOiJKb2tlbiIsImVtYWlsIjoic3VjY2Vzc0BzaW11bGF0b3IuYW1hem9uc2VzLmNvbSIsImV4cCI6MTU4NTI1MzU2MiwiaWF0IjoxNTg1MjQ2MzYyLCJpc3MiOiJKb2tlbiIsImp0aSI6IjJudnVxYW5kbjdhNjFwbTdsczAwMDBxMSIsIm5hbWUiOiJTdXBlciBTdWNjZXNzZnVsIiwibmJmIjoxNTg1MjQ2MzYyLCJ0ZW1wbGF0ZSI6IndlbGNvbWUifQ.rZeABtUwYLGeXopq04gI0VfRBgBUjQQKjAnSG1hs8sQ"

Response:

{
  "aud": "Joken",
  "email": "[email protected]",
  "exp": 1585253562,
  "iat": 1585246362,
  "id": 24,
  "iss": "Joken",
  "jti": "2nvuqandn7a61pm7ls0000q1",
  "name": "Super Successful",
  "nbf": 1585246362,
  "status": "Pending",
  "template": "welcome"
}

[nelsonic]

Documentation added.