TeslaMate项目官方API使用指南：Fleet API与Telemetry API详解

前言

TeslaMate作为一款优秀的特斯拉车辆数据记录与分析工具，其核心功能依赖于特斯拉提供的API接口。随着特斯拉官方API策略的调整，用户需要了解不同API的使用场景和限制。本文将深入解析TeslaMate项目中涉及的两种官方API：Fleet API和Telemetry API，帮助用户做出正确选择。

官方API类型与适用场景

1. 传统Owner API与新版Fleet API对比

传统上，TeslaMate使用非官方的Owner API和流式传输接口。而现在特斯拉提供了两套官方API替代方案：

• Fleet API：替代原有的Owner API
• Telemetry API：替代原有的流式传输接口

2. 用户类型与API选择

根据用户账户类型不同，API使用策略也有所区别：

企业车队用户

• 必须迁移至Fleet API，因为Owner API将逐步关闭
• 迁移时间取决于特斯拉的升级计划
• 当出现API错误时，表明必须使用新版API

个人用户

• 目前仍可继续使用Owner API
• 建议保持现状，直到Owner API完全关闭

新版API的限制与影响

Fleet API的主要限制

1. 数据获取频率受限：

   • 车辆数据(vehicle_data)获取频率有严格限制
   • 命令发送次数受限
   • 历史记录分辨率低于Owner API

2. 功能完整性：

   • 虽然API设计更全面，但某些功能可能受限
   • 预计未来这些限制也会应用到Owner API

Telemetry API的差异

1. 数据传输机制：

   • 使用消息队列而非WebSocket
   • 默认发送至特斯拉指定端点

2. 数据频率：

   • 最低每分钟发送一次数据
   • 远低于原有流式传输的秒级更新

第三方服务提供商方案

对于希望简化配置的用户，可以考虑以下第三方服务：

MyTeslaMate方案(免费)

Fleet API配置步骤

1. 使用特斯拉账户登录MyTeslaMate网站
2. 获取专属TOKEN
3. 配置环境变量：

- TOKEN=?token=您的专属TOKEN
- TESLA_API_HOST=https://api.myteslamate.com
- TESLA_AUTH_HOST=https://api.myteslamate.com
- TESLA_AUTH_PATH=/api/oauth2/v3

流式传输配置

1. 在Fleet页面配对车辆
2. 添加流式传输环境变量：

- TESLA_WSS_HOST=wss://streaming.myteslamate.com
- TESLA_WSS_TLS_ACCEPT_INVALID_CERTS=true
- TESLA_WSS_USE_VIN=true

3. 重启TeslaMate实例

Teslemetry方案(付费)

Fleet API配置

1. 创建Teslemetry账户并获取TOKEN
2. 配置环境变量：

- TOKEN=?token=您的专属TOKEN
- TESLA_API_HOST=https://api.teslemetry.com
- TESLA_AUTH_HOST=https://api.teslemetry.com
- TESLA_AUTH_PATH=/api/oauth2/v3

注意：Teslemetry不提供流式传输服务，需在TeslaMate设置中手动禁用。

直接使用官方API方案(高级)

前置要求

1. 具备IT基础设施管理能力
2. 拥有公网可访问的服务器
3. 申请特斯拉开发者账户和免费Fleet API计划

Fleet API配置指南

1. 在特斯拉开发者平台创建第三方账户

2. 根据所在区域配置API_HOST：

   • 北美/亚太(除中国)：https://fleet-api.prd.na.vn.cloud.tesla.com
   • 欧洲/中东/非洲：https://fleet-api.prd.eu.vn.cloud.tesla.com
   • 中国：https://fleet-api.prd.cn.vn.cloud.tesla.cn

3. 完整环境变量配置：

- TESLA_API_HOST=对应区域URL
- TESLA_AUTH_HOST=https://auth.tesla.com
- TESLA_AUTH_PATH=/oauth2/v3
- TESLA_AUTH_CLIENT_ID=您的应用客户端ID

从Owner API迁移到Fleet API

1. 在TeslaMate设置页面登出当前Owner API
2. 完成上述Fleet API配置
3. 重启Docker实例使更改生效
4. 正确配置后，TeslaMate将自动使用新的客户端ID登录

自建Telemetry流式传输方案

1. 部署Tesla Fleet Telemetry实例
2. 配置Google PubSub分发器
3. 部署流式传输服务器
4. 创建PubSub订阅指向您的流式传输服务器
5. 更新环境变量：

- TESLA_WSS_HOST=wss://您的流式传输域名
- TESLA_WSS_TLS_ACCEPT_INVALID_CERTS=true
- TESLA_WSS_USE_VIN=true

6. 重启实例

总结与建议

1. 企业用户应立即迁移至Fleet API方案
2. 个人用户可暂缓迁移，继续使用Owner API
3. 根据技术能力选择第三方服务或自建方案
4. 流式传输配置较为复杂，需谨慎操作
5. 定期关注特斯拉API政策变化，及时调整配置

通过本文的详细指南，希望TeslaMate用户能够顺利完成API的迁移和配置工作，确保车辆数据记录的连续性。对于技术细节仍有疑问的用户，建议寻求专业技术支持或选择可靠的第三方服务方案。