BMW i Remote API 教程

---

项目介绍

宝马i远程接口是一个基于BMW i3电动车的逆向工程接口，最初由Terence Eden创建，后期经Quentin Stafford-Fraser进行了部分代码修改。这个API允许开发者与他们的宝马i3车辆进行交互，通过分析官方的BMW i Remote安卓应用程序逆向设计而来。请注意，使用这些API完全自担风险。

• 许可证: MIT
• 目标车型: 主要针对宝马i3
• 仓库状态: 已归档(只读)，最后更新于2022年11月11日

项目快速启动

为了开始使用BMW i Remote API，你需要以下步骤：

准备工作

确保你已注册并拥有宝马的ConnectedDrive服务账户，包括：

• 注册邮箱地址
• 登录密码
• i Remote API Key 和 Secret（可以通过反编译安卓应用或截取手机与宝马服务器间通信获取）

示例代码：远程控制充电

你可以通过发送POST请求来控制汽车的不同功能。下面是一个设置定时充电的示例：

curl --request POST \
     --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
     --header 'Content-Type: application/x-www-form-urlencoded' \
     --data-urlencode 'serviceType=CHARGING_CONTROL' \
     --data-urlencode 'data=[...]' \
     'https://b2vapi.bmwgroup.com/webapi/v1/user/vehicles/:VIN/executeService'

这里，:VIN需要替换为你的车辆识别号(VIN)，并且YOUR_ACCESS_TOKEN应换成有效的访问令牌。

注意事项

• 实际使用时，需替换YOUR_ACCESS_TOKEN和:VIN。
• 确保在请求中包含正确的授权头(Authorization: Bearer ...)。
• 车辆响应可能会有延迟，尤其是在信号不佳地区。

应用案例与最佳实践

• 定时充电管理: 利用API设定离家前的自动充电时间，优化电费支出。
• 远程解锁与上锁: 方便家人或紧急情况下的快速访问。
• 气候控制预设: 遥控开启车内空调，确保进入车内的舒适温度。
• 位置追踪: 在大型停车场快速找到车辆位置。

最佳实践

• 定期检查API变更以保持兼容性。
• 强烈建议处理好API调用的错误和异常，避免不必要的数据泄露或操作错误。
• 对敏感信息（如API密钥）进行加密存储。

典型生态项目

由于该项目已归档，目前没有直接的典型生态项目列出。不过，类似的汽车互联开发激发了智能家居集成、车队管理软件以及其他智能交通解决方案的发展。开发者社区可以借鉴此项目，探索构建与汽车交互的新应用，特别是在开放源码物联网(IoT)领域。

---

本教程提供了接入和利用BMW i Remote API的基础知识，对于进一步的创新应用和开发，鼓励开发者深入研究API细节和安全实践。记住，每一次尝试都应遵守相关的隐私法规和技术指南。