把 API 理解成一扇有规则的窗口

API 是软件之间交换信息的约定。Tesla Fleet API 是 Tesla 面向第三方应用提供的官方接口体系,让应用在获得用户授权后,按许可范围访问车辆相关信息或使用相应能力。

“官方接口”描述的是连接渠道,并不代表使用这个渠道的每一个 App 都是 Tesla 官方产品。TessCloud 是独立的第三方车辆数据服务;我们负责把获得授权的数据整理成你能看懂的记录。

授权给的是访问范围,不是 Tesla 密码

连接时,Tesla 账号的登录与授权在 Tesla 官方页面完成。你在这里确认允许的访问范围;TessCloud 接收授权结果,用它建立后续连接,而不是要求你把 Tesla 密码交给我们。

不同权限对应不同能力。读取车辆信息、读取位置、控制车辆,并不是同一件事。理解授权时,应以 Tesla 授权页面列出的范围和当前功能说明为准,不能因为某个 App 能显示路线,就推断它也能执行所有车控。

当前 TessCloud 的数据授权用于登录、保持授权连接、读取车辆数据与位置,没有申请解锁、远程启动或启停充电的权限。整理旅程、设置电价等 App 内的数据操作,也不等于控制车辆。

接口返回数据,产品负责把记录讲清楚

一次状态查询更像一张快照,告诉我们查询时可获得的状态。行程、充电历史和长期趋势,则需要在连接生效后持续积累记录,再进行整理和计算。

因此,接入官方接口不等于自动拥有车辆过去所有的历史。能看到什么,要看授权范围、车辆与地区的能力,以及服务实际积累或接入的记录。连接之前没有采集到的过程,不能靠一个接口重新创造。

这也是为什么电池健康不能只凭一次读数决定,行程地图也不能承诺填满所有空白。接口提供输入,产品需要对每一步处理和每一个结论负责。

Fleet API 和 Fleet Telemetry,不是同一个名字

Tesla 还提供 Fleet Telemetry:在车辆、授权和配置满足条件时,由车辆把选定的信号发送给服务端,减少反复查询车辆状态的需要。

它与普通状态查询的行为和字段覆盖并不完全相同。是否能够使用,取决于车辆软件、配对与服务配置等条件;“Tesla 提供这项能力”也不代表每一辆连接到第三方服务的车都已经启用。

所以,我们不会用“接入 Fleet API”来承诺所有数据都会实时到达,也不会把 Telemetry 的能力直接当作当前每辆车的体验。用户看到的记录,仍要结合实际数据覆盖来理解。

数据为什么会延迟,授权又怎样收回

车辆休眠、网络状况、上游访问限制和授权状态,都可能影响更新。App 能展示某条记录,说明这条信息已经被获取,并不意味着车辆此刻一定还处于同样的状态。判断当前状况时,请留意数据更新时间。

你可以在 Tesla 账号中管理第三方应用并撤销授权。授权变更可能需要一段时间同步;生效后,应用不能继续按原授权访问新数据,但它和删除 TessCloud 已保存的历史记录不是同一件事。需要退出服务时,可以按账号注销说明处理;数据使用范围见隐私政策。

让用户知道连接依赖什么、权限意味着什么、哪里可能存在延迟,是我们解释这套系统的一部分。

进一步阅读

以下为 Tesla 官方文档,接口能力及要求以其最新说明为准。

本文说明 TessCloud 自有数据服务在撰写时的实现思路。其他兼容来源的计算口径可能不同;方法调整后,我们会相应修订说明。

对记录有疑问?联系支持,请勿发送账号密码或访问凭据。