Tesla Token 是什么，怎么安全地拿到它
所有特斯拉第三方工具都会向你要 Token。搞清楚它是什么、为什么不等于你的密码、以及怎么随时撤销，比照着教程点完更重要。
接入任何一个特斯拉第三方服务时，都会碰到这一步：填 Token 和 Refresh Token。很多人到这里会犹豫一下 —— 这东西给出去安全吗？
这个犹豫是对的，也值得花三分钟搞明白。
Token 到底是什么
Token 是 Tesla 官方 OAuth 授权流程发给应用的一张通行证。它的关键性质有三条：
- 它不是你的密码 —— 拿到 Token 的人无法用它登录你的特斯拉账号、无法改密码、无法看到你的支付信息；
- 它会过期 —— Access Token 有效期很短，需要靠 Refresh Token 定期换新；
- 你随时可以作废它 —— 在特斯拉账号里改一次密码，此前签发的所有 Token 立即失效，授权当场撤销。
这也是为什么正规服务不会问你要账号密码。麦特云从不存储你的 Tesla 账号密码，只保存加密后的 Token；撤销权始终在你手里 —— 改个密码就断了。
方式一：网页在线获取（推荐）
最省事的一条路，不用下载任何程序，但只支持桌面端浏览器（手机端不行）：
- 在电脑上打开 token.fsdzy.net；
- 点第 1 步的启动 tesla_auth，用你的 Tesla 账号密码在特斯拉官方页面上登录；
- 登录成功后，点第 2 步的读取 Tesla Auth token，页面会生成 Token 与 Refresh Token；
- 把两个值分别复制，粘贴到麦特云后台的 Token 验证页面对应字段，提交。
两个字段千万别填反。 绑定失败最常见的原因就是 Token 和 Refresh Token 顺序颠倒了 —— 报错信息不会明说，只会告诉你「Token 无效」。
方式二：认证 App 获取（备用）
网页方式不可用时，可以下载官方认证工具。麦特云后台的 Token 验证页面提供各平台下载：iOS 版 Auth app for Tesla，桌面端有 Windows、macOS Intel、macOS Apple Silicon 三个版本。
- 打开 App，先选对区域：中国大陆车主选「中国区」，其余选「全球区」；
- 用 Tesla 账号密码登录（这一步走的是特斯拉官方登录页）；
- App 会生成 Token 与 Refresh Token 两个值；
- 分别复制粘贴到麦特云后台对应字段，提交，等待服务器验证。
区域必须选对。 中国大陆的特斯拉账号走的是独立的认证域，选错区域会直接登录失败 —— 这不是账号问题，重选一次就好。
绑定不上时，按这个顺序排查
| 现象 | 原因 | 怎么办 |
|---|---|---|
| 提示 Token 无效 | 两个字段填反了 | 对调 Token 与 Refresh Token 重新提交 |
| 一直「连接中」/ 网关超时 | 特斯拉验证服务器响应慢 | 耐心多次重试，通常几分钟内成功 |
| 页面提示 Not Found | 在无痕模式或新标签页里打开的 | 从主页点进去，别复制 URL 到新标签页 |
| 后台没显示车辆名称 | 验证流程中断 | 退出登录后重新走一遍 Token 验证 |
| 登录时就失败 | 区域选错了 | 中国大陆账号选「中国区」 |
特斯拉官方的验证服务器有时确实慢，失败一两次很常见。多试几遍通常就过了，不用怀疑是自己填错了 —— 当然前提是先确认没填反。
常见问题
把 Token 给第三方，对方能开我的车吗？
Token 的权限范围由授权时勾选的 scope 决定，其中确实可能包含车辆指令权限 —— 这也是远程开空调、解锁这类功能的基础。所以只把 Token 交给你信任的服务。麦特云对 Token 加密存储，未经你的明确授权不会主动发送控制指令。
怎么撤销授权？
在特斯拉账号里修改一次密码即可 —— 此前签发的所有 Token 立刻失效，所有第三方连接同时断开。这是最彻底也最简单的办法。
Token 会过期吗？要经常重新填吗？
Access Token 有效期很短，但系统会用 Refresh Token 自动续期，正常情况下填一次就够了。只有在你改密码、或长期未使用导致刷新链断掉时，才需要重新绑定。
手机上能获取 Token 吗？
网页方式只支持桌面端浏览器。手机用户可以下载 iOS 版 Auth app for Tesla，或者借一台电脑完成这一步 —— 这一步一辈子只需要做一次。
