Sample code for 30+ languages & platforms
Delphi ActiveX

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 ActiveX Downloads

Delphi ActiveX
var
success: Integer;
createTemplate: Integer;
region: WideString;
host: TChilkatStringBuilder;
signer: TChilkatAuthAws;
connection: TChilkatSocket;
rest: TChilkatRest;
sessionToken: WideString;
request: TChilkatJsonObject;
setupResponse: WideString;
order: TChilkatJsonObject;
tryMissingField: Integer;
preview: TChilkatJsonObject;
responseText: WideString;
response: TChilkatJsonObject;

begin
success := 0;

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

createTemplate := 1;
//  Use the same AWS Region for the identity, endpoint, and Signature Version 4.
region := 'us-west-2';
host := TChilkatStringBuilder.Create(Self);
host.Append('email.');
host.Append(region);
host.Append('.amazonaws.com');

signer := TChilkatAuthAws.Create(Self);
//  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';

connection := TChilkatSocket.Create(Self);
connection.RequireSslCertVerify := 1;
success := connection.Connect(host.GetAsString(),443,1,10000);
if (success <> 1) then
  begin
    Memo1.Lines.Add(connection.LastErrorText);
    Exit;
  end;

rest := TChilkatRest.Create(Self);
success := rest.UseConnection(connection.ControlInterface,0);
if (success <> 1) then
  begin
    Memo1.Lines.Add(rest.LastErrorText);
    Exit;
  end;
success := rest.SetAuthAws(signer.ControlInterface);
if (success <> 1) then
  begin
    Memo1.Lines.Add(rest.LastErrorText);
    Exit;
  end;
//  For temporary AWS credentials, supply the session token from the same provider.
sessionToken := '';
if (sessionToken <> '') then
  begin
    rest.AddQueryParam('X-Amz-Security-Token',sessionToken);
  end;
if (createTemplate = 1) then
  begin
    request := TChilkatJsonObject.Create(Self);
    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');
    setupResponse := rest.FullRequestString('POST','/v2/email/templates',request.Emit());
    if (rest.LastMethodSuccess <> 1) then
      begin
        Memo1.Lines.Add(rest.LastErrorText);
        Exit;
      end;
    if (rest.ResponseStatusCode <> 200) then
      begin
        Memo1.Lines.Add('SES returned HTTP ' + IntToStr(rest.ResponseStatusCode) + ' ' + setupResponse);
        Exit;
      end;
    Memo1.Lines.Add('Template created. Set createTemplate to false to preview it.');
    Exit;
  end;
order := TChilkatJsonObject.Create(Self);
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.
tryMissingField := 0;
if (tryMissingField = 1) then
  begin
    order.Delete('orderNumber');
  end;
preview := TChilkatJsonObject.Create(Self);
preview.UpdateString('TemplateData',order.Emit());

rest.AddHeader('Content-Type','application/json');
responseText := rest.FullRequestString('POST','/v2/email/templates/OrderReceipt/render',preview.Emit());
if (rest.LastMethodSuccess <> 1) then
  begin
    Memo1.Lines.Add(rest.LastErrorText);
    Exit;
  end;
if (rest.ResponseStatusCode <> 200) then
  begin
    Memo1.Lines.Add('SES returned HTTP ' + IntToStr(rest.ResponseStatusCode) + ' ' + responseText);
    Exit;
  end;
response := TChilkatJsonObject.Create(Self);
success := response.Load(responseText);
if (success <> 1) then
  begin
    Memo1.Lines.Add(response.LastErrorText);
    Exit;
  end;
Memo1.Lines.Add(response.StringOf('RenderedTemplate'));