Skip to main content

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:

  1. Get the authorization code (requires Qt5)
  2. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

toyota-na-0.1.4.tar.gz (5.9 kB view details)

Uploaded Source

Built Distribution

toyota_na-0.1.4-py3-none-any.whl (6.7 kB view details)

Uploaded Python 3

File details

Details for the file toyota-na-0.1.4.tar.gz.

File metadata

  • Download URL: toyota-na-0.1.4.tar.gz
  • Upload date:
  • Size: 5.9 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

Hashes for toyota-na-0.1.4.tar.gz
Algorithm Hash digest
SHA256 0f8ccb68addbf5a297242982f9885b888387f1e787dec994d14229fe96db8d8e
MD5 c47490193d08a7b0943da4d6d65ad898
BLAKE2b-256 e311b1cc04df69c5702a8ec6df21b7944d0cb09cfd3237c9542791aae249fbe1

See more details on using hashes here.

File details

Details for the file toyota_na-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: toyota_na-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 6.7 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

Hashes for toyota_na-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a98d49d1d2422f3c12fcdb14660b7631ed1701a7599c1fa3624554f78cdfb7bf
MD5 03a6e19ba2b02b2914a932fcafecf0ec
BLAKE2b-256 55e6e3d204225a193f784579ee4c7c96579ec64bbe46ee501c243b56d475dce8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page