Metadata-Version: 2.1
Name: audiapi
Version: 1.0.1
Summary: Provides access to the Audi Connect API
Home-page: https://github.com/davidgiga1993/AudiAPI
Author: davidgiga1993
Author-email: david@dev-core.org
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries
Description-Content-Type: text/markdown

# Audi Connect API
This library provides access to the Audi Connect API.
It allows easy access to all vehicle relevant data.

The API does automatic session caching and tries to keep the 
original service names as found in the audi connect app.

Some services require special permissions or certain origin countries of the car
to be accessible.

Note: Not all services are fully implemented due to missing permissions as mentioned above. 

# Installing
```bash
pip install audiapi
```

# Examples
## Login credentials
`credentials.json`
```json
{
  "user": "yourUser@mail.com",
  "pass": "yourPassword"
}
```

## List all vehicles under your account
The auth tokens will be cached in the working directory
```python
api = API()
logon_service = LogonService(api)
if not logon_service.restore_token():
	with open('credentials.json') as data_file:
		data = json.load(data_file)
	logon_service.login(data['user'], data['pass'])
car_service = CarService(api)
car_service.get_vehicles()
```
Response
```json
{
	"csid": "-----",
	"vin": "-----",
	"registered": "2017-02-15T18:06:39.000+01:00"
}
```

## Get details about the embedded SIM
```python
mgmt_service = VehicleManagementService(api, vehicle)
mgmt_service.get_information()
```
Response
```json
{
  "vehicleData": {
	"requestId": "--",
	"vin": "--",
	"country": "DE",
	"isConnect": "true",
	"brand": "Audi",
	"vehicleDevices": {
	  "vehicleDevice": [
		{
		  "ecuGeneration": "MIB2high",
		  "deviceType": "INFOTAINMENT"
		},
		{
		  "deviceId": "----",
		  "embeddedSim": {
			"identification": {
			  "content": "----",
			  "type": "ICCID"
			},
			"imei": "----",
			"mno": "vodafone"
		  },
		  "ecuGeneration": "cGW",
		  "deviceType": "TELEMATICS"
		}
	  ]
	},
	"isConnectSorglosReady": "true",
	"systemId": "XID_APP_AUDI"
  }
}
```

# Dependencies
- Python 3
- Requests library

