Sample code for 30+ languages & platforms
JavaScript

SNS Subscribe Email Address

See more Amazon SNS Examples

Subscribe an email address to an SNS topic.

See SNS Subscribe for more information.

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;

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

var rest = new CkRest();

// Connect to the Amazon AWS REST server.
// such as https://sns.us-west-2.amazonaws.com/
var bTls = true;
var port = 443;
var bAutoReconnect = true;
success = rest.Connect("sns.us-west-2.amazonaws.com",port,bTls,bAutoReconnect);

// Provide AWS credentials for the REST call.
var authAws = new CkAuthAws();
authAws.AccessKey = "AWS_ACCESS_KEY";
authAws.SecretKey = "AWS_SECRET_KEY";
// the region should match our URL above..
authAws.Region = "us-west-2";
authAws.ServiceName = "sns";

rest.SetAuthAws(authAws);

rest.AddQueryParam("Action","Subscribe");
rest.AddQueryParam("Endpoint","somebody@some-email-address.com");
rest.AddQueryParam("Protocol","email");
rest.AddQueryParam("TopicArn","arn:aws:sns:us-west-2:957491831129:chilkat");

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

// A successful response will have a status code equal to 200.
if (rest.ResponseStatusCode !== 200) {
    console.log("response status code = " + rest.ResponseStatusCode);
    console.log("response status text = " + rest.ResponseStatusText);
    console.log("response header: " + rest.ResponseHeader);
    console.log("response body: " + responseXml);
    return;
}

// Examine the successful XML response.
var xml = new CkXml();
xml.LoadXml(responseXml);
console.log(xml.GetXml());

// To get the SubscriptionArn (which in this case is "pending confirmation")
console.log("SubscriptionArn: " + xml.ChilkatPath("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>