Zig

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.

Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

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

    const rest = try chilkat.Rest.init();
    defer rest.deinit();

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

    // Provide AWS credentials for the REST call.
    const auth_aws = try chilkat.AuthAws.init();
    defer auth_aws.deinit();
    auth_aws.setAccessKey("AWS_ACCESS_KEY");
    auth_aws.setSecretKey("AWS_SECRET_KEY");
    // the region should match our URL above..
    auth_aws.setRegion("us-west-2");
    auth_aws.setServiceName("ses");

    rest.setAuthAws(auth_aws) catch {};

    rest.addQueryParam("Action", "SendEmail") catch {};

    rest.addQueryParam("Message.Body.Text.Data", "This is a sample plain-text email.") catch {};
    rest.addQueryParam("Message.Body.Text.Charset", "utf-8") catch {};

    rest.addQueryParam("Message.Subject.Data", "Sample plain-text SES email") catch {};
    rest.addQueryParam("Message.Subject.Charset", "utf-8") catch {};

    // 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") catch {};
    // 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") catch {};
    rest.addQueryParam("Destination.CcAddresses.member.2", "somebody@yahoo.com") catch {};
    rest.addQueryParam("Destination.BccAddresses.member.1", "somebody@gmail.com") catch {};

    rest.addQueryParam("Source", "admin@chilkatdownload.com") catch {};

    // 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.
    const response_xml = rest.fullRequestFormUrlEncoded(alloc, "POST", "/") catch {
        std.debug.print("{s}\n", .{try rest.getLastErrorText(alloc)});
        return;
    };

    // A successful response will have a status code equal to 200.
    if (rest.getResponseStatusCode() != 200) {
        std.debug.print("response status code = {d}\n", .{rest.getResponseStatusCode()});
        std.debug.print("response status text = {s}\n", .{try rest.getResponseStatusText(alloc)});
        std.debug.print("response header: {s}\n", .{try rest.getResponseHeader(alloc)});
        std.debug.print("response body: {s}\n", .{response_xml});
        return;
    }

    // Examine the successful XML response.
    const xml = try chilkat.Xml.init();
    defer xml.deinit();
    xml.loadXml(response_xml) catch {};
    std.debug.print("{s}\n", .{try xml.getXml(alloc)});

    // To get the MessageId
    std.debug.print("MessageId: {s}\n", .{try xml.chilkatPath(alloc, "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>
}