node-tado

    0.0.2 • Public • Published

    Build Status

    node-tado

    This is a Node.js client for the Tado smart thermostat web API. It offers a promise-based API.

    Please be aware that this client simply mocks the behaviour of the Tado Web-App. This means that it could stop working due to implemented restrictions by Tado at any time.

    Usage

    Before you can access any API methods, you must perform a login, using your Tado username and password:

    import Tado from 'node-tado';
     
    let client = new Tado();
    client.login('username', 'password').then((success) => {
      // use the client now
    });

    api(path)

    This method handles all API calls. Currently, only GET requests without any parameters are supported – hence this client is only useful for querying data, not for adjusting settings or anything like that.

    client.api('/me').then((result) => {
      console.log('me', result);
    });

    There are a few convenience methods:

    me()

    Shortcut for .api('/me'). Queries data about the logged in user.

    home(homeId)

    Shortcut for .api('/homes/' + homeId).

    zones(homeId)

    Shortcut for .api('/homes/' + homeId + '/zones'). Lists available zones.

    weather(homeId)

    Shortcut for .api('/homes/' + homeId + '/weather'). Fetches current weather data for the location of the given home.

    state(homeId, zoneId)

    Shortcut for .api('/homes/' + homeId + '/zones/' + zoneId + '/state'). Fetches current metrics.

    Keywords

    Install

    npm i node-tado

    DownloadsWeekly Downloads

    0

    Version

    0.0.2

    License

    MIT

    Last publish

    Collaborators

    • dvelopment