email

The email service allows sending of email optionally with attachments. It extends the functionality of the template service allowing the email body to be constructed via a template from JSON data. A request to send an email looks like this:

POST /<base path>/<recipients>/...<template path>

  • base path is the service base path
  • recipients is a comma-separated list of recipients' emails
  • template path is the path to the template which will be used to create the email body.

For example:

/email-service/person@host.com,person2@host.com/template-group-1/message10.html

The POST body contains JSON data which is the data source for the template.

Attachments

The special property attachmentMsgSpecs on the POSTed JSON is used to add attachments to the email. This is an array of strings which are request specs. The email service attaches the returned bodies from the responses from these requests. The request specs are interpreted using the url of the original email request, and the POST body data of the original email request.