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"
Project details
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
Hashes for toyota_na-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2609d384a33bb9a5ba319e6ee1bbcd85c14c9744b1f5da8c1adfea5297dc7256 |
|
MD5 | 1e8be3701dee0e561d6db8bbb64f32ee |
|
BLAKE2b-256 | d0e6017ad49cabbc6a97fee3c6e3e60e863892741f29d5eaab72c7ec8b59a51d |