Sample code for 30+ languages & platforms
Unicode C

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

Chilkat Unicode C Downloads

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

void ChilkatSample(void)
    {
    BOOL success;
    const wchar_t *address;
    const wchar_t *region;
    const wchar_t *accessKey;
    const wchar_t *secretKey;
    const wchar_t *sessionToken;
    HCkStringBuilderW host;
    HCkStringBuilderW mailbox;
    HCkStringBuilderW path;
    HCkStringBuilderW canonicalPath;
    int replaced;
    HCkDateTimeW clock;
    HCkStringBuilderW stamp;
    const wchar_t *date;
    HCkRestW rest;
    HCkStringBuilderW headers;
    const wchar_t *signedHeaders;
    HCkCrypt2W crypto;
    HCkStringBuilderW canonical;
    HCkStringBuilderW scope;
    HCkStringBuilderW toSign;
    HCkStringBuilderW seed;
    const wchar_t *key;
    const wchar_t *signature;
    HCkStringBuilderW authorization;
    HCkSocketW connection;
    const wchar_t *responseText;
    HCkJsonObjectW response;

    success = FALSE;

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

    //  Look up the address exactly as stored, including any plus tag.
    address = L"avery+orders@example.com";
    region = L"us-west-2";
    accessKey = L"AWS_ACCESS_KEY_ID";
    secretKey = L"AWS_SECRET_ACCESS_KEY";
    sessionToken = L"";
    host = CkStringBuilderW_Create();
    CkStringBuilderW_Append(host,L"email.");
    CkStringBuilderW_Append(host,region);
    CkStringBuilderW_Append(host,L".amazonaws.com");
    mailbox = CkStringBuilderW_Create();
    CkStringBuilderW_Append(mailbox,address);
    path = CkStringBuilderW_Create();
    CkStringBuilderW_Append(path,L"/v2/email/suppression/addresses/");
    CkStringBuilderW_Append(path,CkStringBuilderW_getEncoded(mailbox,L"url_rfc3986",L"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.
    canonicalPath = CkStringBuilderW_Create();
    CkStringBuilderW_Append(canonicalPath,CkStringBuilderW_getAsString(path));
    replaced = CkStringBuilderW_Replace(canonicalPath,L"%",L"%25");
    clock = CkDateTimeW_Create();
    CkDateTimeW_SetFromCurrentSystemTime(clock);
    stamp = CkStringBuilderW_Create();
    CkStringBuilderW_Append(stamp,CkDateTimeW_getAsTimestamp(clock,FALSE));
    replaced = CkStringBuilderW_Replace(stamp,L"-",L"");
    replaced = CkStringBuilderW_Replace(stamp,L":",L"");
    date = CkStringBuilderW_getRange(stamp,0,8,FALSE);
    rest = CkRestW_Create();
    CkRestW_AddHeader(rest,L"Host",CkStringBuilderW_getAsString(host));
    CkRestW_AddHeader(rest,L"x-amz-date",CkStringBuilderW_getAsString(stamp));
    headers = CkStringBuilderW_Create();
    CkStringBuilderW_Append(headers,L"host:");
    CkStringBuilderW_Append(headers,CkStringBuilderW_getAsString(host));
    CkStringBuilderW_Append(headers,L"\nx-amz-date:");
    CkStringBuilderW_Append(headers,CkStringBuilderW_getAsString(stamp));
    CkStringBuilderW_Append(headers,L"\n");
    signedHeaders = L"host;x-amz-date";
    if (sessionToken != L"") {
        CkRestW_AddHeader(rest,L"x-amz-security-token",sessionToken);
        CkStringBuilderW_Append(headers,L"x-amz-security-token:");
        CkStringBuilderW_Append(headers,sessionToken);
        CkStringBuilderW_Append(headers,L"\n");
        signedHeaders = L"host;x-amz-date;x-amz-security-token";
    }

    crypto = CkCrypt2W_Create();
    CkCrypt2W_putHashAlgorithm(crypto,L"sha256");
    CkCrypt2W_putMacAlgorithm(crypto,L"hmac");
    CkCrypt2W_putEncodingMode(crypto,L"hexlower");
    CkCrypt2W_putCharset(crypto,L"utf-8");
    canonical = CkStringBuilderW_Create();
    CkStringBuilderW_Append(canonical,L"GET\n");
    CkStringBuilderW_Append(canonical,CkStringBuilderW_getAsString(canonicalPath));
    CkStringBuilderW_Append(canonical,L"\n\n");
    CkStringBuilderW_Append(canonical,CkStringBuilderW_getAsString(headers));
    CkStringBuilderW_Append(canonical,L"\n");
    CkStringBuilderW_Append(canonical,signedHeaders);
    CkStringBuilderW_Append(canonical,L"\n");
    CkStringBuilderW_Append(canonical,CkCrypt2W_hashStringENC(crypto,L""));
    scope = CkStringBuilderW_Create();
    CkStringBuilderW_Append(scope,date);
    CkStringBuilderW_Append(scope,L"/");
    CkStringBuilderW_Append(scope,region);
    CkStringBuilderW_Append(scope,L"/ses/aws4_request");
    toSign = CkStringBuilderW_Create();
    CkStringBuilderW_Append(toSign,L"AWS4-HMAC-SHA256\n");
    CkStringBuilderW_Append(toSign,CkStringBuilderW_getAsString(stamp));
    CkStringBuilderW_Append(toSign,L"\n");
    CkStringBuilderW_Append(toSign,CkStringBuilderW_getAsString(scope));
    CkStringBuilderW_Append(toSign,L"\n");
    CkStringBuilderW_Append(toSign,CkCrypt2W_hashStringENC(crypto,CkStringBuilderW_getAsString(canonical)));

    //  Derive the signing key one HMAC at a time. Decode each intermediate key from hex.
    seed = CkStringBuilderW_Create();
    CkStringBuilderW_Append(seed,L"AWS4");
    CkStringBuilderW_Append(seed,secretKey);
    CkCrypt2W_SetMacKeyString(crypto,CkStringBuilderW_getAsString(seed));
    key = CkCrypt2W_macStringENC(crypto,date);
    CkCrypt2W_SetMacKeyEncoded(crypto,key,L"hex");
    key = CkCrypt2W_macStringENC(crypto,region);
    CkCrypt2W_SetMacKeyEncoded(crypto,key,L"hex");
    key = CkCrypt2W_macStringENC(crypto,L"ses");
    CkCrypt2W_SetMacKeyEncoded(crypto,key,L"hex");
    key = CkCrypt2W_macStringENC(crypto,L"aws4_request");
    CkCrypt2W_SetMacKeyEncoded(crypto,key,L"hex");
    signature = CkCrypt2W_macStringENC(crypto,CkStringBuilderW_getAsString(toSign));
    authorization = CkStringBuilderW_Create();
    CkStringBuilderW_Append(authorization,L"AWS4-HMAC-SHA256 Credential=");
    CkStringBuilderW_Append(authorization,accessKey);
    CkStringBuilderW_Append(authorization,L"/");
    CkStringBuilderW_Append(authorization,CkStringBuilderW_getAsString(scope));
    CkStringBuilderW_Append(authorization,L", SignedHeaders=");
    CkStringBuilderW_Append(authorization,signedHeaders);
    CkStringBuilderW_Append(authorization,L", Signature=");
    CkStringBuilderW_Append(authorization,signature);
    CkRestW_AddHeader(rest,L"Authorization",CkStringBuilderW_getAsString(authorization));
    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);
        CkStringBuilderW_Dispose(mailbox);
        CkStringBuilderW_Dispose(path);
        CkStringBuilderW_Dispose(canonicalPath);
        CkDateTimeW_Dispose(clock);
        CkStringBuilderW_Dispose(stamp);
        CkRestW_Dispose(rest);
        CkStringBuilderW_Dispose(headers);
        CkCrypt2W_Dispose(crypto);
        CkStringBuilderW_Dispose(canonical);
        CkStringBuilderW_Dispose(scope);
        CkStringBuilderW_Dispose(toSign);
        CkStringBuilderW_Dispose(seed);
        CkStringBuilderW_Dispose(authorization);
        CkSocketW_Dispose(connection);
        return;
    }

    success = CkRestW_UseConnection(rest,connection,FALSE);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkStringBuilderW_Dispose(host);
        CkStringBuilderW_Dispose(mailbox);
        CkStringBuilderW_Dispose(path);
        CkStringBuilderW_Dispose(canonicalPath);
        CkDateTimeW_Dispose(clock);
        CkStringBuilderW_Dispose(stamp);
        CkRestW_Dispose(rest);
        CkStringBuilderW_Dispose(headers);
        CkCrypt2W_Dispose(crypto);
        CkStringBuilderW_Dispose(canonical);
        CkStringBuilderW_Dispose(scope);
        CkStringBuilderW_Dispose(toSign);
        CkStringBuilderW_Dispose(seed);
        CkStringBuilderW_Dispose(authorization);
        CkSocketW_Dispose(connection);
        return;
    }

    responseText = CkRestW_fullRequestNoBody(rest,L"GET",CkStringBuilderW_getAsString(path));
    if (CkRestW_getLastMethodSuccess(rest) != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkStringBuilderW_Dispose(host);
        CkStringBuilderW_Dispose(mailbox);
        CkStringBuilderW_Dispose(path);
        CkStringBuilderW_Dispose(canonicalPath);
        CkDateTimeW_Dispose(clock);
        CkStringBuilderW_Dispose(stamp);
        CkRestW_Dispose(rest);
        CkStringBuilderW_Dispose(headers);
        CkCrypt2W_Dispose(crypto);
        CkStringBuilderW_Dispose(canonical);
        CkStringBuilderW_Dispose(scope);
        CkStringBuilderW_Dispose(toSign);
        CkStringBuilderW_Dispose(seed);
        CkStringBuilderW_Dispose(authorization);
        CkSocketW_Dispose(connection);
        return;
    }

    if (CkRestW_getResponseStatusCode(rest) == 404) {
        wprintf(L"No account suppression entry for this address in this Region.\n");
        CkStringBuilderW_Dispose(host);
        CkStringBuilderW_Dispose(mailbox);
        CkStringBuilderW_Dispose(path);
        CkStringBuilderW_Dispose(canonicalPath);
        CkDateTimeW_Dispose(clock);
        CkStringBuilderW_Dispose(stamp);
        CkRestW_Dispose(rest);
        CkStringBuilderW_Dispose(headers);
        CkCrypt2W_Dispose(crypto);
        CkStringBuilderW_Dispose(canonical);
        CkStringBuilderW_Dispose(scope);
        CkStringBuilderW_Dispose(toSign);
        CkStringBuilderW_Dispose(seed);
        CkStringBuilderW_Dispose(authorization);
        CkSocketW_Dispose(connection);
        return;
    }

    if (CkRestW_getResponseStatusCode(rest) != 200) {
        wprintf(L"SES returned HTTP %d %s\n",CkRestW_getResponseStatusCode(rest),responseText);
        CkStringBuilderW_Dispose(host);
        CkStringBuilderW_Dispose(mailbox);
        CkStringBuilderW_Dispose(path);
        CkStringBuilderW_Dispose(canonicalPath);
        CkDateTimeW_Dispose(clock);
        CkStringBuilderW_Dispose(stamp);
        CkRestW_Dispose(rest);
        CkStringBuilderW_Dispose(headers);
        CkCrypt2W_Dispose(crypto);
        CkStringBuilderW_Dispose(canonical);
        CkStringBuilderW_Dispose(scope);
        CkStringBuilderW_Dispose(toSign);
        CkStringBuilderW_Dispose(seed);
        CkStringBuilderW_Dispose(authorization);
        CkSocketW_Dispose(connection);
        return;
    }

    response = CkJsonObjectW_Create();
    success = CkJsonObjectW_Load(response,responseText);
    if (success != TRUE) {
        wprintf(L"%s\n",CkJsonObjectW_lastErrorText(response));
        CkStringBuilderW_Dispose(host);
        CkStringBuilderW_Dispose(mailbox);
        CkStringBuilderW_Dispose(path);
        CkStringBuilderW_Dispose(canonicalPath);
        CkDateTimeW_Dispose(clock);
        CkStringBuilderW_Dispose(stamp);
        CkRestW_Dispose(rest);
        CkStringBuilderW_Dispose(headers);
        CkCrypt2W_Dispose(crypto);
        CkStringBuilderW_Dispose(canonical);
        CkStringBuilderW_Dispose(scope);
        CkStringBuilderW_Dispose(toSign);
        CkStringBuilderW_Dispose(seed);
        CkStringBuilderW_Dispose(authorization);
        CkSocketW_Dispose(connection);
        CkJsonObjectW_Dispose(response);
        return;
    }

    wprintf(L"%s\n",CkJsonObjectW_stringOf(response,L"SuppressedDestination.EmailAddress"));
    wprintf(L"Reason: %s\n",CkJsonObjectW_stringOf(response,L"SuppressedDestination.Reason"));
    wprintf(L"Last updated (Unix seconds): %s\n",CkJsonObjectW_stringOf(response,L"SuppressedDestination.LastUpdateTime"));


    CkStringBuilderW_Dispose(host);
    CkStringBuilderW_Dispose(mailbox);
    CkStringBuilderW_Dispose(path);
    CkStringBuilderW_Dispose(canonicalPath);
    CkDateTimeW_Dispose(clock);
    CkStringBuilderW_Dispose(stamp);
    CkRestW_Dispose(rest);
    CkStringBuilderW_Dispose(headers);
    CkCrypt2W_Dispose(crypto);
    CkStringBuilderW_Dispose(canonical);
    CkStringBuilderW_Dispose(scope);
    CkStringBuilderW_Dispose(toSign);
    CkStringBuilderW_Dispose(seed);
    CkStringBuilderW_Dispose(authorization);
    CkSocketW_Dispose(connection);
    CkJsonObjectW_Dispose(response);

    }