Sample code for 30+ languages & platforms
Delphi DLL

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 Delphi DLL Downloads

Delphi DLL
var
success: Boolean;
createTemplate: Boolean;
region: PWideChar;
host: HCkStringBuilder;
signer: HCkAuthAws;
connection: HCkSocket;
rest: HCkRest;
sessionToken: PWideChar;
request: HCkJsonObject;
setupResponse: PWideChar;
order: HCkJsonObject;
tryMissingField: Boolean;
preview: HCkJsonObject;
responseText: PWideChar;
response: HCkJsonObject;

begin
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 := 'us-west-2';
host := CkStringBuilder_Create();
CkStringBuilder_Append(host,'email.');
CkStringBuilder_Append(host,region);
CkStringBuilder_Append(host,'.amazonaws.com');

signer := CkAuthAws_Create();
//  Supply the credentials from your application's credential provider.
CkAuthAws_putAccessKey(signer,'AWS_ACCESS_KEY_ID');
CkAuthAws_putSecretKey(signer,'AWS_SECRET_ACCESS_KEY');
CkAuthAws_putRegion(signer,region);
CkAuthAws_putServiceName(signer,'ses');

connection := CkSocket_Create();
CkSocket_putRequireSslCertVerify(connection,True);
success := CkSocket_Connect(connection,CkStringBuilder__getAsString(host),443,True,10000);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSocket__lastErrorText(connection));
    Exit;
  end;

rest := CkRest_Create();
success := CkRest_UseConnection(rest,connection,False);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;
success := CkRest_SetAuthAws(rest,signer);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;
//  For temporary AWS credentials, supply the session token from the same provider.
sessionToken := '';
if (sessionToken <> '') then
  begin
    CkRest_AddQueryParam(rest,'X-Amz-Security-Token',sessionToken);
  end;
if (createTemplate = True) then
  begin
    request := CkJsonObject_Create();
    CkJsonObject_UpdateString(request,'TemplateName','OrderReceipt');
    CkJsonObject_UpdateString(request,'TemplateContent.Subject','Receipt for {{orderNumber}}');
    CkJsonObject_UpdateString(request,'TemplateContent.Text','Thank you, {{firstName}}. Order {{orderNumber}}: {{#each items}}{{quantity}} x {{name}}. {{/each}}');
    CkJsonObject_UpdateString(request,'TemplateContent.Html','<p>Thank you, {{firstName}}.</p><ul>{{#each items}}<li>{{quantity}} x {{name}}</li>{{/each}}</ul>');

    CkRest_AddHeader(rest,'Content-Type','application/json');
    setupResponse := CkRest__fullRequestString(rest,'POST','/v2/email/templates',CkJsonObject__emit(request));
    if (CkRest_getLastMethodSuccess(rest) <> True) then
      begin
        Memo1.Lines.Add(CkRest__lastErrorText(rest));
        Exit;
      end;
    if (CkRest_getResponseStatusCode(rest) <> 200) then
      begin
        Memo1.Lines.Add('SES returned HTTP ' + IntToStr(CkRest_getResponseStatusCode(rest)) + ' ' + setupResponse);
        Exit;
      end;
    Memo1.Lines.Add('Template created. Set createTemplate to false to preview it.');
    Exit;
  end;
order := CkJsonObject_Create();
CkJsonObject_UpdateString(order,'firstName','Avery');
CkJsonObject_UpdateString(order,'orderNumber','1042');
CkJsonObject_UpdateString(order,'items[0].name','Notebook');
CkJsonObject_UpdateInt(order,'items[0].quantity',2);
CkJsonObject_UpdateString(order,'items[1].name','Pen');
CkJsonObject_UpdateInt(order,'items[1].quantity',1);
//  Remove this key to try the missing-field case.
tryMissingField := False;
if (tryMissingField = True) then
  begin
    CkJsonObject_Delete(order,'orderNumber');
  end;
preview := CkJsonObject_Create();
CkJsonObject_UpdateString(preview,'TemplateData',CkJsonObject__emit(order));

CkRest_AddHeader(rest,'Content-Type','application/json');
responseText := CkRest__fullRequestString(rest,'POST','/v2/email/templates/OrderReceipt/render',CkJsonObject__emit(preview));
if (CkRest_getLastMethodSuccess(rest) <> True) then
  begin
    Memo1.Lines.Add(CkRest__lastErrorText(rest));
    Exit;
  end;
if (CkRest_getResponseStatusCode(rest) <> 200) then
  begin
    Memo1.Lines.Add('SES returned HTTP ' + IntToStr(CkRest_getResponseStatusCode(rest)) + ' ' + responseText);
    Exit;
  end;
response := CkJsonObject_Create();
success := CkJsonObject_Load(response,responseText);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkJsonObject__lastErrorText(response));
    Exit;
  end;
Memo1.Lines.Add(CkJsonObject__stringOf(response,'RenderedTemplate'));

CkStringBuilder_Dispose(host);
CkAuthAws_Dispose(signer);
CkSocket_Dispose(connection);
CkRest_Dispose(rest);
    CkJsonObject_Dispose(request);
CkJsonObject_Dispose(order);
CkJsonObject_Dispose(preview);
CkJsonObject_Dispose(response);