Rust

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.

Rust

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

let rest = chilkat::Rest::new();

// Connect to the Amazon AWS REST server.
// such as https://email.us-west-2.amazonaws.com/
let b_tls = true;
let port = 443;
let b_auto_reconnect = true;
let _ = rest.connect("email.us-west-2.amazonaws.com", port, b_tls, b_auto_reconnect).is_ok();

// Provide AWS credentials for the REST call.
let auth_aws = chilkat::AuthAws::new();
auth_aws.set_access_key("AWS_ACCESS_KEY");
auth_aws.set_secret_key("AWS_SECRET_KEY");
// the region should match our URL above..
auth_aws.set_region("us-west-2");
auth_aws.set_service_name("ses");

let _ = rest.set_auth_aws(&auth_aws);

let _ = rest.add_query_param("Action", "SendEmail");

let _ = rest.add_query_param("Message.Body.Text.Data", "This is a sample plain-text email.");
let _ = rest.add_query_param("Message.Body.Text.Charset", "utf-8");

let _ = rest.add_query_param("Message.Subject.Data", "Sample plain-text SES email");
let _ = rest.add_query_param("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)
let _ = rest.add_query_param("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!)
let _ = rest.add_query_param("Destination.CcAddresses.member.1", "support@chilkatsoft.com");
let _ = rest.add_query_param("Destination.CcAddresses.member.2", "somebody@yahoo.com");
let _ = rest.add_query_param("Destination.BccAddresses.member.1", "somebody@gmail.com");

let _ = rest.add_query_param("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.
let Ok(response_xml) = rest.full_request_form_url_encoded("POST", "/") else {
    println!("{}", rest.last_error_text());
    return;
};

// A successful response will have a status code equal to 200.
if rest.response_status_code() != 200 {
    println!("response status code = {}", rest.response_status_code());
    println!("response status text = {}", rest.response_status_text());
    println!("response header: {}", rest.response_header());
    println!("response body: {}", response_xml);
    return;
}

// Examine the successful XML response.
let xml = chilkat::Xml::new();
let _ = xml.load_xml(&response_xml);
println!("{}", xml.get_xml().unwrap_or_default());

// To get the MessageId
println!("MessageId: {}", xml.chilkat_path("SendEmailResult|MessageId|*").unwrap_or_default());

// 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>