{"id":16549146,"url":"https://github.com/mihaiblaga89/bmw-connecteddrive-api","last_synced_at":"2025-05-05T16:45:40.997Z","repository":{"id":38455173,"uuid":"210195150","full_name":"mihaiblaga89/bmw-connecteddrive-api","owner":"mihaiblaga89","description":"JavaScript implementation of the BMW's ConnectedDrive API","archived":false,"fork":false,"pushed_at":"2024-06-13T11:41:41.000Z","size":1669,"stargazers_count":37,"open_issues_count":19,"forks_count":8,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-18T20:07:37.461Z","etag":null,"topics":["api","bmw","bmw-connecteddrive"],"latest_commit_sha":null,"homepage":"https://bmwapi.mihaiblaga.dev/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mihaiblaga89.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-22T18:29:50.000Z","updated_at":"2024-10-08T09:00:44.000Z","dependencies_parsed_at":"2023-09-26T22:58:22.088Z","dependency_job_id":"5b65fb37-85d0-49a9-82c2-e55bb0d131ec","html_url":"https://github.com/mihaiblaga89/bmw-connecteddrive-api","commit_stats":{"total_commits":424,"total_committers":5,"mean_commits":84.8,"dds":0.3160377358490566,"last_synced_commit":"d2c6ad9bd4b87d37f79b5cca7bb033cd4ed916b5"},"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mihaiblaga89%2Fbmw-connecteddrive-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mihaiblaga89%2Fbmw-connecteddrive-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mihaiblaga89%2Fbmw-connecteddrive-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mihaiblaga89%2Fbmw-connecteddrive-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mihaiblaga89","download_url":"https://codeload.github.com/mihaiblaga89/bmw-connecteddrive-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252535641,"owners_count":21763985,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","bmw","bmw-connecteddrive"],"created_at":"2024-10-11T19:28:25.862Z","updated_at":"2025-05-05T16:45:40.974Z","avatar_url":"https://github.com/mihaiblaga89.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bmw-connecteddrive-api\n\n[![codecov](https://codecov.io/gh/mihaiblaga89/bmw-connecteddrive-api/branch/master/graph/badge.svg)](https://codecov.io/gh/mihaiblaga89/bmw-connecteddrive-api)\n[![Actions Status](https://github.com/mihaiblaga89/bmw-connecteddrive-api/workflows/tests/badge.svg)](https://github.com/mihaiblaga89/bmw-connecteddrive-api/actions)\n[![CodeFactor](https://www.codefactor.io/repository/github/mihaiblaga89/bmw-connecteddrive-api/badge/master)](https://www.codefactor.io/repository/github/mihaiblaga89/bmw-connecteddrive-api/overview/master)\n[![License](https://img.shields.io/npm/l/@mihaiblaga89/bmw-connecteddrive-api)](https://github.com/mihaiblaga89/bmw-connecteddrive-api/blob/master/LICENSE)\n\nJavaScript implementation of the BMW's ConnectedDrive API\n\nExample: [BMWStatus](https://github.com/mihaiblaga89/bmw-status-app)\n\n## Usage\n\n```javascript\nimport API from '@mihaiblaga89/bmw-connecteddrive-api';\n\nawait API.init({\n    region: 'eu',\n    username: 'user@example.com',\n    password: 'mySuperPassword',\n});\n\nconst vehicles = await API.getVehicles();\n\nconst vehicleStatus = await vehicles[0].getStatus();\n```\n\n## API Methods\n\n#### API.init(options)\n\nInitializes the API with your credentials. By default it also fetches your vehicles and saves them but you can disable this behaviour if you want. [More info](https://bmwapi.mihaiblaga.dev/?api#API#init)\n\n#### API.getVehicles(force)\n\nReturns your prefetched vehicles or queries the BMW API for them. Has the option to force the query to refresh your vehicles. Every vehicle is an instance of [Vehicle](https://bmwapi.mihaiblaga.dev/?api#Vehicle). [More info](https://bmwapi.mihaiblaga.dev/?api#API#getVehicles)\n\n## Vehicle Methods\n\n#### Vehicle.getImage(width, height, view)\n\nFetches and caches your vehicle image from BMW API. Of course it's not the actual photo, it's just a car photo based on your car's model and color :). Several \"views\" are available. [More info](https://bmwapi.mihaiblaga.dev/?api#Vehicle#getImage)\n\n#### Vehicle.getStatus(force)\n\nFetches and caches the car's status from the API. Can be forced. Returns an instance of [VehicleStatus](https://bmwapi.mihaiblaga.dev/?api#VehicleStatus). [More info](https://bmwapi.mihaiblaga.dev/?api#Vehicle#getStatus)\n\n## Acknowledgments\n\nThis work was inspired by the following repos:\n\n-   https://github.com/bimmerconnected/bimmer_connected\n-   https://github.com/edent/BMW-i-Remote\n-   https://shkspr.mobi/blog/2015/11/reverse-engineering-the-bmw-i3-api/\n\nThank you for your efforts and hard work.\n\n## License\n\n-   [MIT License](https://github.com/mihaiblaga89/bmw-connecteddrive-api/blob/master/LICENSE)\n\n## Disclaimer\n\nThis library is not affiliated nor endorsed by BMW Group / Bayerische Motoren Werke AG.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmihaiblaga89%2Fbmw-connecteddrive-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmihaiblaga89%2Fbmw-connecteddrive-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmihaiblaga89%2Fbmw-connecteddrive-api/lists"}