Sample code for 30+ languages & platforms
Unicode 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 Unicode C Downloads

Unicode C
#include <C_CkStringBuilderW.h>
#include <C_CkAuthAwsW.h>
#include <C_CkSocketW.h>
#include <C_CkRestW.h>
#include <C_CkJsonObjectW.h>

void ChilkatSample(void)
    {
    BOOL success;
    BOOL createTemplate;
    const wchar_t *region;
    HCkStringBuilderW host;
    HCkAuthAwsW signer;
    HCkSocketW connection;
    HCkRestW rest;
    const wchar_t *sessionToken;
    HCkJsonObjectW request;
    const wchar_t *setupResponse;
    HCkJsonObjectW order;
    BOOL tryMissingField;
    HCkJsonObjectW preview;
    const wchar_t *responseText;
    HCkJsonObjectW response;

    success = FALSE;

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

    createTemplate = TRUE;
    //  Use the same AWS Region for the identity, endpoint, and Signature Version 4.
    region = L"us-west-2";
    host = CkStringBuilderW_Create();
    CkStringBuilderW_Append(host,L"email.");
    CkStringBuilderW_Append(host,region);
    CkStringBuilderW_Append(host,L".amazonaws.com");

    signer = CkAuthAwsW_Create();
    //  Supply the credentials from your application's credential provider.
    CkAuthAwsW_putAccessKey(signer,L"AWS_ACCESS_KEY_ID");
    CkAuthAwsW_putSecretKey(signer,L"AWS_SECRET_ACCESS_KEY");
    CkAuthAwsW_putRegion(signer,region);
    CkAuthAwsW_putServiceName(signer,L"ses");

    connection = CkSocketW_Create();
    CkSocketW_putRequireSslCertVerify(connection,TRUE);
    success = CkSocketW_Connect(connection,CkStringBuilderW_getAsString(host),443,TRUE,10000);
    if (success != TRUE) {
        wprintf(L"%s\n",CkSocketW_lastErrorText(connection));
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        return;
    }

    rest = CkRestW_Create();
    success = CkRestW_UseConnection(rest,connection,FALSE);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        return;
    }

    success = CkRestW_SetAuthAws(rest,signer);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        return;
    }

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

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

        CkRestW_AddHeader(rest,L"Content-Type",L"application/json");
        setupResponse = CkRestW_fullRequestString(rest,L"POST",L"/v2/email/templates",CkJsonObjectW_emit(request));
        if (CkRestW_getLastMethodSuccess(rest) != TRUE) {
            wprintf(L"%s\n",CkRestW_lastErrorText(rest));
            CkStringBuilderW_Dispose(host);
            CkAuthAwsW_Dispose(signer);
            CkSocketW_Dispose(connection);
            CkRestW_Dispose(rest);
            CkJsonObjectW_Dispose(request);
            return;
        }

        if (CkRestW_getResponseStatusCode(rest) != 200) {
            wprintf(L"SES returned HTTP %d %s\n",CkRestW_getResponseStatusCode(rest),setupResponse);
            CkStringBuilderW_Dispose(host);
            CkAuthAwsW_Dispose(signer);
            CkSocketW_Dispose(connection);
            CkRestW_Dispose(rest);
            CkJsonObjectW_Dispose(request);
            return;
        }

        wprintf(L"Template created. Set createTemplate to false to preview it.\n");
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        CkJsonObjectW_Dispose(request);
        return;
    }

    order = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(order,L"firstName",L"Avery");
    CkJsonObjectW_UpdateString(order,L"orderNumber",L"1042");
    CkJsonObjectW_UpdateString(order,L"items[0].name",L"Notebook");
    CkJsonObjectW_UpdateInt(order,L"items[0].quantity",2);
    CkJsonObjectW_UpdateString(order,L"items[1].name",L"Pen");
    CkJsonObjectW_UpdateInt(order,L"items[1].quantity",1);
    //  Remove this key to try the missing-field case.
    tryMissingField = FALSE;
    if (tryMissingField == TRUE) {
        CkJsonObjectW_Delete(order,L"orderNumber");
    }

    preview = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(preview,L"TemplateData",CkJsonObjectW_emit(order));

    CkRestW_AddHeader(rest,L"Content-Type",L"application/json");
    responseText = CkRestW_fullRequestString(rest,L"POST",L"/v2/email/templates/OrderReceipt/render",CkJsonObjectW_emit(preview));
    if (CkRestW_getLastMethodSuccess(rest) != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        CkJsonObjectW_Dispose(request);
        CkJsonObjectW_Dispose(order);
        CkJsonObjectW_Dispose(preview);
        return;
    }

    if (CkRestW_getResponseStatusCode(rest) != 200) {
        wprintf(L"SES returned HTTP %d %s\n",CkRestW_getResponseStatusCode(rest),responseText);
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        CkJsonObjectW_Dispose(request);
        CkJsonObjectW_Dispose(order);
        CkJsonObjectW_Dispose(preview);
        return;
    }

    response = CkJsonObjectW_Create();
    success = CkJsonObjectW_Load(response,responseText);
    if (success != TRUE) {
        wprintf(L"%s\n",CkJsonObjectW_lastErrorText(response));
        CkStringBuilderW_Dispose(host);
        CkAuthAwsW_Dispose(signer);
        CkSocketW_Dispose(connection);
        CkRestW_Dispose(rest);
        CkJsonObjectW_Dispose(request);
        CkJsonObjectW_Dispose(order);
        CkJsonObjectW_Dispose(preview);
        CkJsonObjectW_Dispose(response);
        return;
    }

    wprintf(L"%s\n",CkJsonObjectW_stringOf(response,L"RenderedTemplate"));


    CkStringBuilderW_Dispose(host);
    CkAuthAwsW_Dispose(signer);
    CkSocketW_Dispose(connection);
    CkRestW_Dispose(rest);
    CkJsonObjectW_Dispose(request);
    CkJsonObjectW_Dispose(order);
    CkJsonObjectW_Dispose(preview);
    CkJsonObjectW_Dispose(response);

    }