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
1 Jan 17, 2022
![[roscoe]](https://avatars.githubusercontent.com/u/12989039?v=4&s=60)
145 Sep 14, 2022
1 Mar 21, 2022
8 Dec 04, 2022
130 May 28, 2022
1 Dec 17, 2021
1 Jan 11, 2022
127 Dec 23, 2022
7 Apr 24, 2022
1 Dec 28, 2021
3 Dec 27, 2021
9 Nov 29, 2022
55 Dec 13, 2022
21 Dec 01, 2022
28 Dec 06, 2022
1 Feb 09, 2022
1 Jan 23, 2022
1 Nov 01, 2021
1 Nov 13, 2021
58 Dec 16, 2022