Carwings Javascript API Library and Tools

This code is meant for interacting with the Nissan Leaf Carwings API. This API allows one to query a swath of information about the vehicle, some of it cached in the cloud and some pulled directly from the vehicle over its cellular connectivity. The API also allows modifying a limited set of vehicle states (AC on/off, charge start/stop).

It is written for node.js and uses the babel transpiler mainly for taking advantage of es6 modules and es8(?) async/await to make network ops more pleasant to work with.

Getting Started

The code in src is the non-transpiled source, and in lib can be found the transpiled library that is ready to be require()'d directly from node >= ^6.9 (may work on older, but this is untested).

After cloning the code (and installing node.js) simply run npm install to install required dependencies.

Usage

var carwings = require('carwings');

carwings.loginSession('username', 'password', 'regioncode').then(function(session){
  //Get cached current LEAF status
  carwings.batteryRecords(session).then(function(status){
    console.log(status);
  });

  //Initiate battery check
  carwings.batteryStatusCheckRequest(session).then(function(checkStatus){
    console.log(checkStatus);
  });

  //Enable HVAC
  carwings.hvacOn(session).then(function(status){
    console.log(status);
  });

  //Disable HVAC
  carwings.hvacOff(session).then(function(status){
    console.log(status);
  });

  //Get HVAC status
  carwings.hvacStatus(session).then(function(status){
    console.log(status);
  });
});

regioncode options: NNA = USA, NE = Europe, NCI = Canada, NMA = Australia, NML = Japan. (source)

Development

There are currently a couple simple helper scripts defined in package.json:

• npm run build will transpile from src to lib
• npm run bstart will run the code from src directly using babel-node for a simplified dev cycle.

License

MIT, yo.