Sample code for 30+ languages & platforms
JavaScript

Amazon SES v2: Check an address on the account suppression list

See more Amazon SES Examples

Look up one address in the sending Region with ses:GetSuppressedDestination. The record distinguishes a bounce from a complaint. An absent record tells you only that this account suppression lookup found no entry. The example signs the exact encoded mailbox path and also works with temporary credentials.

GetSuppressedDestination

Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat v11.4.0 or greater.
JavaScript
var success = false;

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

//  Look up the address exactly as stored, including any plus tag.
var address = "avery+orders@example.com";
var region = "us-west-2";
var accessKey = "AWS_ACCESS_KEY_ID";
var secretKey = "AWS_SECRET_ACCESS_KEY";
var sessionToken = "";
var host = new CkStringBuilder();
host.Append("email.");
host.Append(region);
host.Append(".amazonaws.com");
var mailbox = new CkStringBuilder();
mailbox.Append(address);
var path = new CkStringBuilder();
path.Append("/v2/email/suppression/addresses/");
path.Append(mailbox.GetEncoded("url_rfc3986","utf-8"));

//  SigV4 for SES encodes the wire path a second time in the canonical request.
//  Only the canonical copy escapes the percent signs. Send the original path over HTTPS.
var canonicalPath = new CkStringBuilder();
canonicalPath.Append(path.GetAsString());
var replaced = canonicalPath.Replace("%","%25");
var clock = new CkDateTime();
clock.SetFromCurrentSystemTime();
var stamp = new CkStringBuilder();
stamp.Append(clock.GetAsTimestamp(false));
replaced = stamp.Replace("-","");
replaced = stamp.Replace(":","");
var date = stamp.GetRange(0,8,false);
var rest = new CkRest();
rest.AddHeader("Host",host.GetAsString());
rest.AddHeader("x-amz-date",stamp.GetAsString());
var headers = new CkStringBuilder();
headers.Append("host:");
headers.Append(host.GetAsString());
headers.Append("\nx-amz-date:");
headers.Append(stamp.GetAsString());
headers.Append("\n");
var signedHeaders = "host;x-amz-date";
if (sessionToken !== "") {
    rest.AddHeader("x-amz-security-token",sessionToken);
    headers.Append("x-amz-security-token:");
    headers.Append(sessionToken);
    headers.Append("\n");
    signedHeaders = "host;x-amz-date;x-amz-security-token";
}

var crypto = new CkCrypt2();
crypto.HashAlgorithm = "sha256";
crypto.MacAlgorithm = "hmac";
crypto.EncodingMode = "hexlower";
crypto.Charset = "utf-8";
var canonical = new CkStringBuilder();
canonical.Append("GET\n");
canonical.Append(canonicalPath.GetAsString());
canonical.Append("\n\n");
canonical.Append(headers.GetAsString());
canonical.Append("\n");
canonical.Append(signedHeaders);
canonical.Append("\n");
canonical.Append(crypto.HashStringENC(""));
var scope = new CkStringBuilder();
scope.Append(date);
scope.Append("/");
scope.Append(region);
scope.Append("/ses/aws4_request");
var toSign = new CkStringBuilder();
toSign.Append("AWS4-HMAC-SHA256\n");
toSign.Append(stamp.GetAsString());
toSign.Append("\n");
toSign.Append(scope.GetAsString());
toSign.Append("\n");
toSign.Append(crypto.HashStringENC(canonical.GetAsString()));

//  Derive the signing key one HMAC at a time. Decode each intermediate key from hex.
var seed = new CkStringBuilder();
seed.Append("AWS4");
seed.Append(secretKey);
crypto.SetMacKeyString(seed.GetAsString());
var key = crypto.MacStringENC(date);
crypto.SetMacKeyEncoded(key,"hex");
key = crypto.MacStringENC(region);
crypto.SetMacKeyEncoded(key,"hex");
key = crypto.MacStringENC("ses");
crypto.SetMacKeyEncoded(key,"hex");
key = crypto.MacStringENC("aws4_request");
crypto.SetMacKeyEncoded(key,"hex");
var signature = crypto.MacStringENC(toSign.GetAsString());
var authorization = new CkStringBuilder();
authorization.Append("AWS4-HMAC-SHA256 Credential=");
authorization.Append(accessKey);
authorization.Append("/");
authorization.Append(scope.GetAsString());
authorization.Append(", SignedHeaders=");
authorization.Append(signedHeaders);
authorization.Append(", Signature=");
authorization.Append(signature);
rest.AddHeader("Authorization",authorization.GetAsString());
var connection = new CkSocket();
connection.RequireSslCertVerify = true;
success = connection.Connect(host.GetAsString(),443,true,10000);
if (success !== true) {
    console.log(connection.LastErrorText);
    return;
}

success = rest.UseConnection(connection,false);
if (success !== true) {
    console.log(rest.LastErrorText);
    return;
}

var responseText = rest.FullRequestNoBody("GET",path.GetAsString());
if (rest.LastMethodSuccess !== true) {
    console.log(rest.LastErrorText);
    return;
}

if (rest.ResponseStatusCode == 404) {
    console.log("No account suppression entry for this address in this Region.");
    return;
}

if (rest.ResponseStatusCode !== 200) {
    console.log("SES returned HTTP " + rest.ResponseStatusCode + " " + responseText);
    return;
}

var response = new CkJsonObject();
success = response.Load(responseText);
if (success !== true) {
    console.log(response.LastErrorText);
    return;
}

console.log(response.StringOf("SuppressedDestination.EmailAddress"));
console.log("Reason: " + response.StringOf("SuppressedDestination.Reason"));
console.log("Last updated (Unix seconds): " + response.StringOf("SuppressedDestination.LastUpdateTime"));