Toyota Connected Services Europe Python module

⚠️ This is still in beta ⚠️ Only EU is supported, other regions are not possible so far.

Summary

• Toyota Connected Services Europe Python module
  • Description
  • Installation
  • Docs
  • Usage
  • Known issues
  • Contributing
  • Note
  • Credits

Description

Python 3 package to communicate with Toyota Connected Europe Services. This is an unofficial package and Toyota can change their API at any point without warning.

Installation

This package can be installed through pip.

pip install pytoyoda

Docs

https://pytoyoda.github.io/pytoyoda/pytoyoda.html

Usage

For a quick start on how to use the package take a look at the simple_client_example.py file contained in the report. You can also use and execute this file directly by using the following commands:

python -m venv pytoyoda
source pytoyoda/bin/activate
python -m pip install "pytoyoda@git+https://github.com/pytoyoda/pytoyoda@main"
curl -LO https://raw.githubusercontent.com/pytoyoda/pytoyoda/main/sandbox/simple_client_example.py
# Create a credentials.json file with {"username":"your@mail.tld","password":"yourpassword"}
python simple_client_example.py

Please note that the simple_client_example.py file is only to be regarded as a playground and is intended to provide an initial insight into the possibilities. It is not an officially supported interface of the pytoyoda API! For an overview of the current official interfaces, please take a look at our documentation.

Known issues

• Statistical endpoint will return None if no trip have been performed in the requested timeframe. This problem will often happen at the start of each week, month or year. Also daily stats will of course also be unavailable if no trip have been performed.
• Currently, it is only possible to get various vehicle information. Functions for controlling and setting vehicle properties have not yet been implemented.
• GET /v1/global/remote/status (used by Vehicle.lock_status) returns 429 APIGW-403 "Unauthorized" frequently, often without obvious correlation to call rate. Empirically, issuing POST /v1/global/remote/refresh-status first - the same wake the Toyota Android app uses - improves the success rate of subsequent GETs and gives fresher occurrence_date payloads, suggesting at least some of the 429s come from a stale or empty server-side cache rather than rate-limiting. Other 429s appear to be unrelated to cache state and happen seemingly at random; pytoyoda retries those with exponential backoff. Call Vehicle.refresh_status() first, then poll Vehicle.update(only=["status"]) until lock_status.last_updated advances.
• Trip history retention. Toyota's trips API (used by get_trips()/get_summary()) only serves roughly the last 12 months of trips, regardless of the from_date you request. This is a limitation of Toyota's backend, not of pytoyoda: trips older than the retention window are permanently deleted on Toyota's side and cannot be recovered through this library, the MyToyota app, the data export portal, or a GDPR data request (Toyota has confirmed this in writing - see #273). If you want to keep a longer history, periodically fetch and store get_trips() results locally (e.g. keyed on the trip's stable id) before the retention window rolls past them.

Contributing

This python module uses poetry (>= 2.0.0) and pre-commit.

To start contributing, fork this repository and run poetry install. Then create a new branch. Before making a PR, please run pre-commit poetry run pre-commit run --all-files and make sure that all tests passes locally first by running pytest tests/.

Note

This is a friendly community fork of the original project by @DurgNomis-drol, to ease up on maintenance and the bus factor for this project.

Credits

Special thanks go @DurgNomis-drol for starting this project! A huge thanks go to @calmjm for making tojota.