Dart

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.

Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // This example requires the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  final rest = CkRest();

  // Connect to the Amazon AWS REST server.
  // such as https://email.us-west-2.amazonaws.com/
  final bTls = true;
  final port = 443;
  final bAutoReconnect = true;
  rest.connect('email.us-west-2.amazonaws.com', port, bTls, bAutoReconnect);

  // Provide AWS credentials for the REST call.
  final authAws = CkAuthAws();
  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.
  final String responseXml;
  try {
    responseXml = rest.fullRequestFormUrlEncoded('POST', '/');
  } on ChilkatException catch (e) {
    print(e.lastErrorText);
    return;
  }

  // A successful response will have a status code equal to 200.
  if (rest.responseStatusCode != 200) {
    print('response status code = ${rest.responseStatusCode}');
    print('response status text = ${rest.responseStatusText}');
    print('response header: ${rest.responseHeader}');
    print('response body: $responseXml');
    return;
  }

  // Examine the successful XML response.
  final xml = CkXml();
  xml.loadXml(responseXml);
  print(xml.getXml());

  // To get the MessageId
  print('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>
}