B4X

SES Send Plain-Text Email

See more Amazon SES Examples

Sends a simple plain-text email to one or more recipients.

See SES SendEmail for more information.

B4X

Dim success As Boolean = False

'  This example requires the Chilkat API to have been previously unlocked.
'  See Global Unlock Sample for sample code.

Dim rest As ChilkatRest
rest.Initialize("rest")

'  Connect to the Amazon AWS REST server.
'  such as https://email.us-west-2.amazonaws.com/
Dim bTls As Boolean = True
Dim port As Int = 443
Dim bAutoReconnect As Boolean = True
success = rest.Connect("email.us-west-2.amazonaws.com", port, bTls, bAutoReconnect)

'  Provide AWS credentials for the REST call.
Dim authAws As ChilkatAuthAws
authAws.Initialize
authAws.AccessKey = "AWS_ACCESS_KEY"
authAws.SecretKey = "AWS_SECRET_KEY"
'  the region should match our URL above..
authAws.Region = "us-west-2"
authAws.ServiceName = "ses"

rest.SetAuthAws(authAws)

rest.AddQueryParam("Action", "SendEmail")

rest.AddQueryParam("Message.Body.Text.Data", "This is a sample plain-text email.")
rest.AddQueryParam("Message.Body.Text.Charset", "utf-8")

rest.AddQueryParam("Message.Subject.Data", "Sample plain-text SES email")
rest.AddQueryParam("Message.Subject.Charset", "utf-8")

'  Add up to 100 TO, CC, and BCC recipients.
'  If your SES account is still in the sandbox, you also must verify every recipient email address except for the recipients 
'  provided by the Amazon SES mailbox simulator. (See http://docs.aws.amazon.com/ses/latest/DeveloperGuide/mailbox-simulator.html)
rest.AddQueryParam("Destination.ToAddresses.member.1", "success@simulator.amazonses.com")
'  Please do not test by sending email to Chilkat (Thanks!)
'  Please do not test by sending email to Chilkat (Thanks!)
'  Please do not test by sending email to Chilkat (Thanks!)
rest.AddQueryParam("Destination.CcAddresses.member.1", "support@chilkatsoft.com")
rest.AddQueryParam("Destination.CcAddresses.member.2", "somebody@yahoo.com")
rest.AddQueryParam("Destination.BccAddresses.member.1", "somebody@gmail.com")

rest.AddQueryParam("Source", "admin@chilkatdownload.com")

'  Because there may be a large amount of data in the query params, use a POST
'  where the params are sent in the body of the HTTP Request.
Dim responseXml As String = rest.FullRequestFormUrlEncoded("POST", "/")
If rest.LastMethodSuccess = False Then
    Log(rest.LastErrorText)
    Return
End If


'  A successful response will have a status code equal to 200.
If rest.ResponseStatusCode <> 200 Then
    Log("response status code = " & rest.ResponseStatusCode)
    Log("response status text = " & rest.ResponseStatusText)
    Log("response header: " & rest.ResponseHeader)
    Log("response body: " & responseXml)
    Return
End If


'  Examine the successful XML response.
Dim xml As ChilkatXml
xml.Initialize
xml.LoadXml(responseXml)
Log(xml.GetXml)

'  To get the MessageId
Log("MessageId: " & xml.ChilkatPath("SendEmailResult|MessageId|*"))

'  A sample successful response:
'  <?xml version="1.0" encoding="utf-8" ?>
'  <SendEmailResponse xmlns="http://ses.amazonaws.com/doc/2010-12-01/">
'      <SendEmailResult>
'          <MessageId>010101579081d2c1-043c693f-5a23-4c64-a8c1-66187d3725a0-000000</MessageId>
'      </SendEmailResult>
'      <ResponseMetadata>
'          <RequestId>e2b5b480-8a4e-11e6-85cd-21b1f1f6d432</RequestId>
'      </ResponseMetadata>
'  </SendEmailResponse>