This python library lets you use the Volvo Cars API. Authorisation follows the OAuth 2.0 authorisation code flow with PKCE.
You'll need a Volvo Developers account and create an API application. Make sure to fill in all required fields and write down the retrieved client id and secret.
A script is worth a thousand words.
# Retrieved at the end of the API application registration process
client_id = "abc"
client_secret = "very-secret-key"
# Scopes that have been requested during the API application registration. You can also
# use less scopes than requested.
scopes = [
"openid",
"conve:battery_charge_level",
"conve:brake_status",
"conve:climatization_start_stop",
"conve:command_accessibility",
"conve:commands",
"conve:diagnostics_engine_status",
# ...
]
# Must be excactly as entered during the API application registration
redirect_uri = "htttps://my-volvo-application.io/callback"
# The VCC API key retrieved after the API application registration process
api_key = "abcdef-1234567890-abcdef"
client_session = _get_client_session()
# Authenticate
auth = VolvoCarsAuth(
client_session,
client_id=client_id,
client_secret=client_secret,
scopes=scopes,
redirect_uri=redirect_uri)
auth_uri = await auth.get_auth_uri() # optionally pass state
# Redirect user to auth_uri and wait for the callback
# ...
# Extract code from the callback url
code = _get_code_from_url()
await auth.async_request_token(code)
# The VIN must be linked to the account you sign in with
vin = "YV123456789012345"
# Create API client
api = VolvoCarsApi(client_session, auth, api_key, vin)
# Make API request
engine_warnings = await api.async_get_engine_warnings()If you'd like to show your appreciation for this project, feel free to toss a coin to your dev. Donations help keep things running — and who knows, maybe one day they'll add up to a Volvo EX90 (hey, let me dream!). If you're feeling generous, you may donate one too — I'll even come pick it up! 😁
