(Tcl) SNS Subscribe Email Address

Subscribe an email address to an SNS topic.

See SNS Subscribe for more information.

Chilkat Tcl Extension Downloads Chilkat Tcl Extension Downloads

load ./chilkat.dll

# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

set rest [new_CkRest]

# Connect to the Amazon AWS REST server.
# such as https://sns.us-west-2.amazonaws.com/
set bTls 1
set port 443
set bAutoReconnect 1
set success [CkRest_Connect $rest "sns.us-west-2.amazonaws.com" $port $bTls $bAutoReconnect]

# Provide AWS credentials for the REST call.
set authAws [new_CkAuthAws]

CkAuthAws_put_AccessKey $authAws "AWS_ACCESS_KEY"
CkAuthAws_put_SecretKey $authAws "AWS_SECRET_KEY"
# the region should match our URL above..
CkAuthAws_put_Region $authAws "us-west-2"
CkAuthAws_put_ServiceName $authAws "sns"

CkRest_SetAuthAws $rest $authAws

CkRest_AddQueryParam $rest "Action" "Subscribe"
CkRest_AddQueryParam $rest "Endpoint" "somebody@some-email-address.com"
CkRest_AddQueryParam $rest "Protocol" "email"
CkRest_AddQueryParam $rest "TopicArn" "arn:aws:sns:us-west-2:957491831129:chilkat"

set responseXml [CkRest_fullRequestNoBody $rest "GET" "/"]
if {[CkRest_get_LastMethodSuccess $rest] != 1} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    delete_CkAuthAws $authAws
    exit
}

# A successful response will have a status code equal to 200.
if {[CkRest_get_ResponseStatusCode $rest] != 200} then {
    puts "response status code = [CkRest_get_ResponseStatusCode $rest]"
    puts "response status text = [CkRest_responseStatusText $rest]"
    puts "response header: [CkRest_responseHeader $rest]"
    puts "response body: $responseXml"
    delete_CkRest $rest
    delete_CkAuthAws $authAws
    exit
}

# Examine the successful XML response.
set xml [new_CkXml]

CkXml_LoadXml $xml $responseXml
puts [CkXml_getXml $xml]

# To get the SubscriptionArn (which in this case is "pending confirmation")
puts "SubscriptionArn: [CkXml_chilkatPath $xml SubscribeResult|SubscriptionArn|*]"

# A sample successful response:
# <?xml version="1.0" encoding="utf-8" ?>
# <SubscribeResponse xmlns="http://sns.amazonaws.com/doc/2010-03-31/">
#     <SubscribeResult>
#         <SubscriptionArn>pending confirmation</SubscriptionArn>
#     </SubscribeResult>
#     <ResponseMetadata>
#         <RequestId>c5490a81-973b-5fa6-93dc-5bed689c212f</RequestId>
#     </ResponseMetadata>
# </SubscribeResponse>

delete_CkRest $rest
delete_CkAuthAws $authAws
delete_CkXml $xml