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

Objective-C
#import <NSString.h>
#import <CkoStringBuilder.h>
#import <CkoAuthAws.h>
#import <CkoSocket.h>
#import <CkoRest.h>
#import <CkoJsonObject.h>

BOOL success = NO;

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

BOOL createTemplate = YES;
//  Use the same AWS Region for the identity, endpoint, and Signature Version 4.
NSString *region = @"us-west-2";
CkoStringBuilder *host = [[CkoStringBuilder alloc] init];
[host Append: @"email."];
[host Append: region];
[host Append: @".amazonaws.com"];

CkoAuthAws *signer = [[CkoAuthAws alloc] init];
//  Supply the credentials from your application's credential provider.
signer.AccessKey = @"AWS_ACCESS_KEY_ID";
signer.SecretKey = @"AWS_SECRET_ACCESS_KEY";
signer.Region = region;
signer.ServiceName = @"ses";

CkoSocket *connection = [[CkoSocket alloc] init];
connection.RequireSslCertVerify = YES;
success = [connection Connect: [host GetAsString] port: [NSNumber numberWithInt: 443] ssl: YES maxWaitMs: [NSNumber numberWithInt: 10000]];
if (success != YES) {
    NSLog(@"%@",connection.LastErrorText);
    return;
}

CkoRest *rest = [[CkoRest alloc] init];
success = [rest UseConnection: connection autoReconnect: NO];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

success = [rest SetAuthAws: signer];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

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

if (createTemplate == YES) {
    CkoJsonObject *request = [[CkoJsonObject alloc] init];
    [request UpdateString: @"TemplateName" value: @"OrderReceipt"];
    [request UpdateString: @"TemplateContent.Subject" value: @"Receipt for {{orderNumber}}"];
    [request UpdateString: @"TemplateContent.Text" value: @"Thank you, {{firstName}}. Order {{orderNumber}}: {{#each items}}{{quantity}} x {{name}}. {{/each}}"];
    [request UpdateString: @"TemplateContent.Html" value: @"<p>Thank you, {{firstName}}.</p><ul>{{#each items}}<li>{{quantity}} x {{name}}</li>{{/each}}</ul>"];

    [rest AddHeader: @"Content-Type" value: @"application/json"];
    NSString *setupResponse = [rest FullRequestString: @"POST" uriPath: @"/v2/email/templates" bodyText: [request Emit]];
    if (rest.LastMethodSuccess != YES) {
        NSLog(@"%@",rest.LastErrorText);
        return;
    }

    if ([rest.ResponseStatusCode intValue] != 200) {
        NSLog(@"%@%d%@%@",@"SES returned HTTP ",[rest.ResponseStatusCode intValue],@" ",setupResponse);
        return;
    }

    NSLog(@"%@",@"Template created. Set createTemplate to false to preview it.");
    return;
}

CkoJsonObject *order = [[CkoJsonObject alloc] init];
[order UpdateString: @"firstName" value: @"Avery"];
[order UpdateString: @"orderNumber" value: @"1042"];
[order UpdateString: @"items[0].name" value: @"Notebook"];
[order UpdateInt: @"items[0].quantity" value: [NSNumber numberWithInt: 2]];
[order UpdateString: @"items[1].name" value: @"Pen"];
[order UpdateInt: @"items[1].quantity" value: [NSNumber numberWithInt: 1]];
//  Remove this key to try the missing-field case.
BOOL tryMissingField = NO;
if (tryMissingField == YES) {
    [order Delete: @"orderNumber"];
}

CkoJsonObject *preview = [[CkoJsonObject alloc] init];
[preview UpdateString: @"TemplateData" value: [order Emit]];

[rest AddHeader: @"Content-Type" value: @"application/json"];
NSString *responseText = [rest FullRequestString: @"POST" uriPath: @"/v2/email/templates/OrderReceipt/render" bodyText: [preview Emit]];
if (rest.LastMethodSuccess != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

if ([rest.ResponseStatusCode intValue] != 200) {
    NSLog(@"%@%d%@%@",@"SES returned HTTP ",[rest.ResponseStatusCode intValue],@" ",responseText);
    return;
}

CkoJsonObject *response = [[CkoJsonObject alloc] init];
success = [response Load: responseText];
if (success != YES) {
    NSLog(@"%@",response.LastErrorText);
    return;
}

NSLog(@"%@",[response StringOf: @"RenderedTemplate"]);