toyota-na
Python client for Toyota North America service API
Install
pip install toyota-na[qt]
[qt] is required for generating authorization code.
Usage
python -m toyota_na.app -h # Get help
python -m toyota_na.app get_user_vehicle_list # List vehicle
python -m toyota_na.app get_vehicle_status
# Get vehcicle status
...
Developer Guide
Quick Start
from toyota_na.client import ToyotaOneClient
cli = ToyotaOneClient()
cli.auth.login()
vehicle_list = cli.get_user_vehicle_list()
vehicle_status = cli.get_vehicle_status(vehicle_list[0]["vin])
...
About authorization
Toyota OAuth2 service require the redirect_uri to be "com.toyota.oneapp:/oauth2Callback". we need to mock this app. We use PyQt5 to intercept the redirection in this module. Qt5 application can not be launched in a server side setup, such as Home Assistant. Alternatively, the login can be separated to two steps here:
- Get the authorization code (requires Qt5)
- Use the code to retrieve the tokens
To get the authorization code:
python -m toyota_na.app authorize
To use the authorization code:
- In python code:
from toyota_na.client import ToyotaOneClient
cli = ToyotaOneClient()
cli.auth.login(authorization_code)
- In CLI:
python -m toyota_na.app authorize
Samples
Sample responses from API calls are stored in samples folder. The data is from Toyota app's "Demo Mode"
1 Dec 18, 2021
10 Jan 5, 2023
157 Nov 22, 2022
9 Dec 12, 2022
56 Nov 30, 2022
27 Sep 21, 2022
483 Dec 31, 2022
400 Dec 19, 2022
2.9k Dec 30, 2022
16 Nov 01, 2022
21 Dec 25, 2022
23 Dec 07, 2022
8 Feb 28, 2022
3 Feb 22, 2022
5 Mar 24, 2022
1 Jan 06, 2022
71 Jan 03, 2023
3 Dec 31, 2021
3 Oct 21, 2022
10 Dec 19, 2022
1 Nov 30, 2021
19 Jan 11, 2022
3 Nov 27, 2021
47 Dec 19, 2022
8 Oct 21, 2022
28 Aug 30, 2022
1 Jan 04, 2022
2 Oct 27, 2021
9 Nov 16, 2022