公告和API变更日志

未来对车队遥测功能的更改将记录在 车队遥测更新日志 中。

我们很高兴地宣布推出新的 Fleet API 支持中心，旨在简化和增强您提交支持请求的方式。作为此次过渡的一部分，我们之前的支持电子邮件 fleetapi-support@tesla.com 将逐步停用，不再接受咨询。要提交支持请求，请单击开发人员仪表板中的支持查询链接：https://developer.tesla.com/dashboard。

运行固件版本 2024.44.32 或更高版本的车辆现在支持车队遥测的两个每字段配置选项：

• minimum_delta：字段值必须改变的最小量，超过此值才会被认为发生了变化。这对于经常发生微小不重要变化的字段（如充电器电压、车内温度等）非常有用。此选项要求 prefer_typed 设置为 true，并且仅支持数值字段。
• resend_interval_seconds：即使字段值没有变化，也会每隔 x 秒重新发送其值。车辆必须运行固件版本 2024.44.32 或更高版本。

此范围为开发人员和用户提供了更细粒度的数据访问控制。对于用户来说，它将显示“允许访问您车辆的位置信息，包括精确位置和粗略位置等数据，以提供近似位置服务。”

这对于应用程序开发人员和用户意味着什么?

• 开发人员：应用程序现在可以在授权用户时请求vehicle_location范围，从而允许他们访问车辆位置信息。
• 用户：用户：vehicle_location范围现在将显示在需要它的应用程序的授权页面上。

迁移计划

1. 2024 年 11 月 - 引入了“vehicle_location”范围。当加载“vehicle_device_data”范围时，/authorize 页面将向用户显示“vehicle_location”范围。迁移期过后，将需要显式请求“vehicle_location”范围。
2. 2024 年 12 月 - 如果合作伙伴应用程序用例需要，合作伙伴必须开始明确请求“vehicle_location”范围以获取新授权，并指导现有用户授权“vehicle_location”范围。
3. 2025 年 1 月 - 没有“vehicle_location”范围的授权将失去对位置相关功能的访问权限。

仅请求必要的范围：根据 Fleet API 协议并为了确保用户信任和安全，仅允许请求应用程序运行所必需的范围的授权。

有关更多信息，请参阅范围。

现在，Fleet API 支持 充电 和 预处理 计划命令。这些命令应优先于计划充电和出发命令。

车辆必须运行固件版本 2024.26 或更高版本。

车队遥测的入门设置不再需要提交 CSR 给特斯拉。运行固件版本 2024.26.4 或更高版本的车辆可以通过 Vehicle Command 代理接收配置。完整的设置详情可以在 车队遥测 页面查看。

已提交但尚未处理的 CSR 申请应迁移至使用新的车辆指挥方法。

使用 CSR 配置的应用程序将继续运行，但建议迁移到新的流程。

现在可以通过单击应用程序的“凭据和API”部分中的“API 和范围管理”链接，在developer.tesla.cn 上更新应用程序范围。如第三方令牌 身份验证部分的 #5 中所述，用户可以使用更新/撤销 auth.tesla.cn 页面更新范围并撤销对应用程序的访问权限。注意：应用程序范围更改最多可能需要 10 分钟才能生效。

Fleet API 是 Tesla 官方的第三方 API，也是唯一受支持的车辆交互 API。可用端点列表可以在此处找到 Fleet API：区域要求。从 2024 年 4 月开始，任何不属于此列表的车辆 API 将被逐步淘汰。根据 Fleet API 政策，继续使用不受支持的 API 将导致撤销 Fleet API 访问权限。

随着 Tesla 移动应用程序 4.30.0 的发布，车辆配对 将需要该应用程序公钥保留托管在用于应用程序注册的“/.well-known/”路径中。这是一项安全改进，其中包括车辆交互信任链中的合作伙伴域。请参阅 check_csr 脚本，了解测试已注册公钥在应用程序域上是否存在的示例。

作为安全性改进的一部分，获取新的刷新令牌现在将使用户的先前的刷新令牌及其关联的访问令牌失效。

现在可以注册 fleet-telemetry 车辆了。有关更多信息，请参阅此处。

请使用SDK将任何调用或集成命令API (Command API) 的程序迁移至特斯拉车辆命令协议 (Tesla Vehicle Command Protocol)。

当调用需要 Tesla 车辆指令协议的车辆的 /command 端点时，Fleet API 将返回错误。

运行固件版本2023.38+的车辆默认不会在车辆数据中返回位置信息。需要该信息的开发人员需要将“location_data”参数添加到查询中，请参阅此处. 这将导致位置共享图标显示在车辆UI上。

重要提示：不建议定期获取车辆数据， 请查看车队Telemetry以满足流数据需求。

随着Tesla车辆命令SDK的发布，对现有REST API车辆命令端点的支持也会结束。从2024年开始，大多数车辆将需要通过Tesla车辆命令SDK发送命令。

为了让开发更便捷，以及加速向Tesla车辆命令SDK的过渡，建议开发者使用Tesla http代理 。如果适用，代理会将Rest API HTTP命令转换为签名命令。配置完成后，开发人员只需将其应用程序指向代理，而无需对其应用程序进行任何代码更改。

Tesla车辆命令SDK提供用于向车辆发送命令的端到端身份验证。这是向车辆发送命令的推荐方式。

我们鼓励安全专家更深入地研究该协议并在Github提供反馈. 要报告安全问题，请按照https://www.tesla.cn/legal/security上的说明进行操作。