Tesla Fleet API OAuth 网关

项目范围

该服务处理 Tesla Fleet API 的合作方认证与第三方账户授权：注册 Partner Account、公开 EC 公钥、发起 OAuth、接收回调、缓存令牌，并代理车辆列表、配置与充电历史查询。

令牌策略

• Partner Token 在进程内缓存，并在过期前主动刷新

• 第三方 access token 不返回浏览器，通过 HttpOnly 会话 Cookie 关联

• refresh token 轮换时原子替换旧值

• 上游返回 401 时清理缓存、刷新并最多重试一次

错误边界

Fleet API 的 error、error_description 与 messages 被解析为统一错误类型，同时保留 429 的 Retry-After 和 RateLimit-Reset，调用方可以区分认证失败、限流与业务错误。

安全约束

调试日志可以临时输出敏感令牌，但生产配置必须关闭，并清理相关日志。

已知限制

当前会话与第三方令牌保存在进程内存中，适合单实例验证。若进入多实例部署，需要迁移到 Redis 或数据库，并对 refresh token 加密存储。这个限制会在项目说明中明确呈现。

项目价值

这是一个边界清晰的外部 API 集成案例：重点不在接口数量，而在令牌生命周期、失败恢复、速率限制和敏感信息处理。