Sample code for 30+ languages & platforms
C++

Amazon SES v2: Create and preview a receipt template

See more Amazon SES Examples

Create the regional OrderReceipt template once. Set createTemplate to false to preview it with sample order data. To exercise the missing-field case, omit orderNumber from the preview data and inspect the rendering error. A successful preview returns MIME content without sending a message.

CreateEmailTemplate · TestRenderEmailTemplate

Chilkat C++ Downloads

C++
#include <CkStringBuilder.h>
#include <CkAuthAws.h>
#include <CkSocket.h>
#include <CkRest.h>
#include <CkJsonObject.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    success = false;

    bool createTemplate = true;
    //  Use the same AWS Region for the identity, endpoint, and Signature Version 4.
    const char *region = "us-west-2";
    CkStringBuilder host;
    host.Append("email.");
    host.Append(region);
    host.Append(".amazonaws.com");

    CkAuthAws signer;
    //  Supply the credentials from your application's credential provider.
    signer.put_AccessKey("AWS_ACCESS_KEY_ID");
    signer.put_SecretKey("AWS_SECRET_ACCESS_KEY");
    signer.put_Region(region);
    signer.put_ServiceName("ses");

    CkSocket connection;
    connection.put_RequireSslCertVerify(true);
    success = connection.Connect(host.getAsString(),443,true,10000);
    if (success != true) {
        std::cout << connection.lastErrorText() << "\r\n";
        return;
    }

    CkRest rest;
    success = rest.UseConnection(connection,false);
    if (success != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    success = rest.SetAuthAws(signer);
    if (success != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    //  For temporary AWS credentials, supply the session token from the same provider.
    const char *sessionToken = "";
    if (sessionToken != "") {
        rest.AddQueryParam("X-Amz-Security-Token",sessionToken);
    }

    if (createTemplate == true) {
        CkJsonObject request;
        request.UpdateString("TemplateName","OrderReceipt");
        request.UpdateString("TemplateContent.Subject","Receipt for {{orderNumber}}");
        request.UpdateString("TemplateContent.Text","Thank you, {{firstName}}. Order {{orderNumber}}: {{#each items}}{{quantity}} x {{name}}. {{/each}}");
        request.UpdateString("TemplateContent.Html","<p>Thank you, {{firstName}}.</p><ul>{{#each items}}<li>{{quantity}} x {{name}}</li>{{/each}}</ul>");

        rest.AddHeader("Content-Type","application/json");
        const char *setupResponse = rest.fullRequestString("POST","/v2/email/templates",request.emit());
        if (rest.get_LastMethodSuccess() != true) {
            std::cout << rest.lastErrorText() << "\r\n";
            return;
        }

        if (rest.get_ResponseStatusCode() != 200) {
            std::cout << "SES returned HTTP " << rest.get_ResponseStatusCode() << " " << setupResponse << "\r\n";
            return;
        }

        std::cout << "Template created. Set createTemplate to false to preview it." << "\r\n";
        return;
    }

    CkJsonObject order;
    order.UpdateString("firstName","Avery");
    order.UpdateString("orderNumber","1042");
    order.UpdateString("items[0].name","Notebook");
    order.UpdateInt("items[0].quantity",2);
    order.UpdateString("items[1].name","Pen");
    order.UpdateInt("items[1].quantity",1);
    //  Remove this key to try the missing-field case.
    bool tryMissingField = false;
    if (tryMissingField == true) {
        order.Delete("orderNumber");
    }

    CkJsonObject preview;
    preview.UpdateString("TemplateData",order.emit());

    rest.AddHeader("Content-Type","application/json");
    const char *responseText = rest.fullRequestString("POST","/v2/email/templates/OrderReceipt/render",preview.emit());
    if (rest.get_LastMethodSuccess() != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    if (rest.get_ResponseStatusCode() != 200) {
        std::cout << "SES returned HTTP " << rest.get_ResponseStatusCode() << " " << responseText << "\r\n";
        return;
    }

    CkJsonObject response;
    success = response.Load(responseText);
    if (success != true) {
        std::cout << response.lastErrorText() << "\r\n";
        return;
    }

    std::cout << response.stringOf("RenderedTemplate") << "\r\n";
    }