Tcl

SNS Subscribe SMS Phone Number

See more Amazon SNS Examples

Subscribe the phone number of an SMS-enabled device to an SNS topic.

See SNS Subscribe for more information.

Tcl

load ./chilkat.dll

set success 0

# 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"
# Set the Endpoint to the phone number in E.164 format
CkRest_AddQueryParam $rest "Endpoint" "+15552581871"
CkRest_AddQueryParam $rest "Protocol" "sms"
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
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>arn:aws:sns:us-west-2:957491831129:chilkat:7eb142f7-2554-4200-a175-bb399588972f</SubscriptionArn>
#     </SubscribeResult>
#     <ResponseMetadata>
#         <RequestId>ceaf538b-1daf-5580-b73f-b347e3733932</RequestId>
#     </ResponseMetadata>
# </SubscribeResponse>

delete_CkRest $rest
delete_CkAuthAws $authAws
delete_CkXml $xml