Merge branch 'vis4573-master'

Author: chrisbarr

README.md

@@ -63,6 +63,7 @@ Available methods:
 * `unsubscribe($subscriptionArn)`
 * `createPlatformEndpoint($platformApplicationArn, $token, $userData)`
 * `deleteEndpoint($deviceArn)`
+* `pushToEndpoint($deviceArn,$message)`
 
 To set the API region (us-east-1, us-west-2, us-west-1, eu-west-1, etc):
 

lib/AmazonSNS.php

@@ -466,6 +466,27 @@ public function deleteEndpoint($deviceArn) {
 		return true;
 	}
 
+	/**
+	 * Push a message to an Endpoint
+	 *
+	 * @link http://docs.amazonwebservices.com/sns/latest/api/API_Publish.html
+	 * @param string $deviceArn
+	 * @param string $message    
+	 * @return string
+	 * @throws InvalidArgumentException
+	 */
+	public function pushToEndpoint($deviceArn, $message) {
+		if (empty($deviceArn) || empty($message)) {
+			throw new InvalidArgumentException('Must supply DeviceArn and Message');
+		}
+
+		$resultXml = $this->_request('Publish', array(
+			'TargetArn' => $deviceArn,
+			'Message' => $message)
+		);
+
+		return strval($resultXml->PublishResult->MessageId);
+	}
 
 	//
 	// Private functions