This component API has been decomissioned on the 31st of May 2018 by Telstra (#15757)

See #15668

homeassistant/components/notify/telstra.py

@@ -1,104 +0,0 @@
-"""
-Telstra API platform for notify component.
-
-For more details about this platform, please refer to the documentation at
-https://home-assistant.io/components/notify.telstra/
-"""
-import logging
-
-from aiohttp.hdrs import CONTENT_TYPE, AUTHORIZATION
-import requests
-import voluptuous as vol
-
-from homeassistant.components.notify import (
-    ATTR_TITLE, PLATFORM_SCHEMA, BaseNotificationService)
-from homeassistant.const import CONTENT_TYPE_JSON
-import homeassistant.helpers.config_validation as cv
-
-_LOGGER = logging.getLogger(__name__)
-
-CONF_CONSUMER_KEY = 'consumer_key'
-CONF_CONSUMER_SECRET = 'consumer_secret'
-CONF_PHONE_NUMBER = 'phone_number'
-
-PLATFORM_SCHEMA = PLATFORM_SCHEMA.extend({
-    vol.Required(CONF_CONSUMER_KEY): cv.string,
-    vol.Required(CONF_CONSUMER_SECRET): cv.string,
-    vol.Required(CONF_PHONE_NUMBER): cv.string,
-})
-
-
-def get_service(hass, config, discovery_info=None):
-    """Get the Telstra SMS API notification service."""
-    consumer_key = config.get(CONF_CONSUMER_KEY)
-    consumer_secret = config.get(CONF_CONSUMER_SECRET)
-    phone_number = config.get(CONF_PHONE_NUMBER)
-
-    if _authenticate(consumer_key, consumer_secret) is False:
-        _LOGGER.exception("Error obtaining authorization from Telstra API")
-        return None
-
-    return TelstraNotificationService(
-        consumer_key, consumer_secret, phone_number)
-
-
-class TelstraNotificationService(BaseNotificationService):
-    """Implementation of a notification service for the Telstra SMS API."""
-
-    def __init__(self, consumer_key, consumer_secret, phone_number):
-        """Initialize the service."""
-        self._consumer_key = consumer_key
-        self._consumer_secret = consumer_secret
-        self._phone_number = phone_number
-
-    def send_message(self, message="", **kwargs):
-        """Send a message to a user."""
-        title = kwargs.get(ATTR_TITLE)
-
-        # Retrieve authorization first
-        token_response = _authenticate(
-            self._consumer_key, self._consumer_secret)
-        if token_response is False:
-            _LOGGER.exception("Error obtaining authorization from Telstra API")
-            return
-
-        # Send the SMS
-        if title:
-            text = '{} {}'.format(title, message)
-        else:
-            text = message
-
-        message_data = {
-            'to': self._phone_number,
-            'body': text,
-        }
-        message_resource = 'https://api.telstra.com/v1/sms/messages'
-        message_headers = {
-            CONTENT_TYPE: CONTENT_TYPE_JSON,
-            AUTHORIZATION: 'Bearer {}'.format(token_response['access_token']),
-        }
-        message_response = requests.post(
-            message_resource, headers=message_headers, json=message_data,
-            timeout=10)
-
-        if message_response.status_code != 202:
-            _LOGGER.exception("Failed to send SMS. Status code: %d",
-                              message_response.status_code)
-
-
-def _authenticate(consumer_key, consumer_secret):
-    """Authenticate with the Telstra API."""
-    token_data = {
-        'client_id': consumer_key,
-        'client_secret': consumer_secret,
-        'grant_type': 'client_credentials',
-        'scope': 'SMS'
-    }
-    token_resource = 'https://api.telstra.com/v1/oauth/token'
-    token_response = requests.get(
-        token_resource, params=token_data, timeout=10).json()
-
-    if 'error' in token_response:
-        return False
-
-    return token_response