Python client for Toyota North America service API
Project description
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 <vin> # Get vehcicle status
...
Developer Guide
Quick Start
from toyota_na.client import ToyotaOneClient
async def main():
cli = ToyotaOneClient()
await cli.auth.login()
vehicle_list = await cli.get_user_vehicle_list()
vehicle_status = await 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:
from toyota_na.client import ToyotaOneClient
cli = ToyotaOneClient()
cli.auth.login(authorization_code)
- In CLI:
python -m toyota_na.app authorize <authorization_code>
Samples
Sample responses from API calls are stored in samples folder. The data is from Toyota app's "Demo Mode"
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file toyota-na-0.1.1.tar.gz.
File metadata
- Download URL: toyota-na-0.1.1.tar.gz
- Upload date:
- Size: 5.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 86add2687d9cbb6dcfd7e5480a6aeea1a4a810378f458c6398e09c951348f98e |
|
| MD5 | fc36df9da7efdd4eba8e60e56fa94bab |
|
| BLAKE2b-256 | 2a75fb5763bb5841d68da024db2359f5016718214d6aeef5f0aafea1322bd18f |
File details
Details for the file toyota_na-0.1.1-py3-none-any.whl.
File metadata
- Download URL: toyota_na-0.1.1-py3-none-any.whl
- Upload date:
- Size: 6.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.22.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2609d384a33bb9a5ba319e6ee1bbcd85c14c9744b1f5da8c1adfea5297dc7256 |
|
| MD5 | 1e8be3701dee0e561d6db8bbb64f32ee |
|
| BLAKE2b-256 | d0e6017ad49cabbc6a97fee3c6e3e60e863892741f29d5eaab72c7ec8b59a51d |
