renault-api 0.5.10

Renault API

Features

This Python package manages the communication with the private Renault API used by the official MyRenault application.

The client is able to read various vehicle attributes, such as:

• mileage

• GPS location

• fuel autonomy (for fuel vehicles)

• battery autonomy (for electric vehicles)

• contracts associated to the vehicle (warranty and connected services)

For some vehicles, it is also possible to manage:

• hvac/pre-conditionning of the vehicle

• charge schedule

This package has been developed to be used with Home-Assistant, but it can be used in other contexts

Requirements

• Python (>= 3.10)

API Usage

You can install Renault API via pip from PyPI:

$ pip install renault-api

import aiohttp
import asyncio

from renault_api.renault_client import RenaultClient

async def main():
   async with aiohttp.ClientSession() as websession:
      client = RenaultClient(websession=websession, locale="fr_FR")
      await client.session.login('email', 'password')
      print(f"Accounts: {await client.get_person()}") # List available accounts, make a note of kamereon account id

      account_id = "Your Kamereon account id"
      account = await client.get_api_account(account_id)
      print(f"Vehicles: {await account.get_vehicles()}") # List available vehicles, make a note of vehicle VIN

      vin = "Your vehicle VIN"
      vehicle = await account.get_api_vehicle(vin)
      print(f"Cockpit information: {await vehicle.get_cockpit()}")
      print(f"Battery status information: {await vehicle.get_battery_status()}")

loop = asyncio.get_event_loop()
loop.run_until_complete(main())

Avoiding password storage

The password is only needed once: session.login exchanges it for a Gigya login token, which acts as a refresh token used to mint access tokens (JWTs). Read it from session.login_token after login, store it securely instead of the password, and restore it on the next session with session.set_login_token:

await client.session.login('email', 'password')
login_token = client.session.login_token  # persist this, not the password

# later, in a new session:
client.session.set_login_token(login_token)  # no password required

CLI Usage

The renault-api is also available through a CLI, which requires additional dependencies. For the added dependencies, you can install Renault API via pip from PyPI:

$ pip install renault-api[cli]

Once installed, the following command prompts for credentials and settings, displays basic vehicle status information, and generates traces:

$ renault-api --log status

• Credentials will automatically be stored in the user home directory (~/.credentials/renault-api.json)

• Logs will automatically be generated in logs subfolder

It is also possible to use raw http GET/POST commands, for example to get odometer and others data on a Windows machine:

C:> renault-api http get /commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/cockpit

Or to request a battery status refresh on a Windows Machine (internal quotes escaped, whole payload enclosed in un-escaped quotes):

C:> renault-api http post /commerce/v1/accounts/{account_id}/kamereon/kca/car-adapter/v1/cars/{vin}/actions/refresh-battery-status "{\\"data\\": {\\"type\\": \\"RefreshBatteryStatus\\"}}"

Please see the Command-line Reference for full details.

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license, Renault API is free and open source software.

Disclaimer

This project is not affiliated with, endorsed by, or connected to Renault. I accept no responsibility for any consequences, intended or accidental, as a as a result of interacting with Renault’s API using this project.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @cjolowicz’s Hypermodern Python Cookiecutter template. This project was heavily based on @jamesremuscat’s PyZE python client for the Renault ZE API.