https://github.com/edent/bmw-i-remote
A reverse engineered interface for the BMW i3 Electric Car
https://github.com/edent/bmw-i-remote
Last synced: about 1 year ago
JSON representation
A reverse engineered interface for the BMW i3 Electric Car
- Host: GitHub
- URL: https://github.com/edent/bmw-i-remote
- Owner: edent
- License: mit
- Archived: true
- Created: 2015-11-25T15:16:33.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2022-01-13T14:44:27.000Z (over 4 years ago)
- Last Synced: 2024-11-03T03:31:41.482Z (over 1 year ago)
- Language: Python
- Size: 50.8 KB
- Stars: 389
- Watchers: 41
- Forks: 60
- Open Issues: 19
-
Metadata Files:
- Readme: README-python.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# The Python BMW API wrapper
The `bmw.py` file is a basic module that you can import to make convenient use of the (unofficial, unsupported) BMW i3 API. For details of the API, please see the main [README.md](README.md) file.
To use this, you will need to know some authentication details used by your phone app. This can be discovered by capturing the traffic between the app and the server -- a process which beyond the scope of this document. The protocol requires an 'access token', which expires periodically and is then regenerated using your API key and secret (analagous to your username and password). You can discover these by looking at the traffic at the time the app is re-authenticating.
The request will contain the base64-encoded version of key:secret, which can be put in the credentials.json file as 'auth_basic'. Until that time, you may be able to capture the access token and use that.
Here's a very simple demo:
import bmw
import json
car = bmw.ConnectedDrive()
resp = car.call("/user/vehicles/")
veh = resp['vehicles'][0]
print (json.dumps(veh, indent=2))
vin = veh['vin']
status = car.call("/user/vehicles/{}/status".format(vin))['vehicleStatus']
print (json.dumps(status, indent=2))