身份验证
API 端点需要身份验证令牌。它必须包含在标题中
Authorization: Bearer <token>
令牌类型
有三种类型的令牌,每种令牌用于不同的目的。识别适合您的应用程序的正确令牌类型非常重要。否则,您可能无法从API收到预期的响应。
选择最符合您使用案例的令牌类型。
- 我是开发人员,正在基于Fleet API构建闭源软件。我将访问用户的帐户: 第三方令牌。
- 我有一个注册的Tesla for Business帐户,并希望与我公司的特斯拉产品进行互动: 合作伙伴令牌。
- 如果您是企业并希望自助注册Tesla for Business,请访问自助注册页面。
- 我是一个爱好者,想与自己的特斯拉产品进行互动: 第三方令牌。
- 我希望调用合作伙伴端点页面上的端点: 合作伙伴令牌。
范围
范围用于限制API访问仅限于您的应用程序所需的数据。
名称 | 范围 | 描述 |
---|---|---|
使用特斯拉登录 | openid | 允许特斯拉客户使用其特斯拉凭据登录应用程序。 |
刷新令牌 | offline_access | 允许获取刷新令牌而无需用户再次登录。 |
个人资料信息 | user_data | 联系信息、家庭地址、个人资料图片和推荐信息。 |
车辆信息 | vehicle_device_data | 允许访问您车辆的实时数据、服务历史记录、服务计划数据、服务通信、符合条件的升级、附近的超级充电站和所有权详细信息。注意:此权限授予车辆位置数据访问权限。 2025年第一季度,只有车辆位置权限才能控制位置数据访问。 |
车辆位置 | vehicle_location | 允许访问您的车辆位置信息,包括精确位置等数据以及粗略位置等近似位置服务。 |
车辆命令 | vehicle_cmds | 添加/删除司机、访问实时摄像头、解锁、唤醒、远程启动和安排软件更新等命令。 |
车辆充电管理 | vehicle_charging_cmds | 车辆充电历史、账单金额、充电地点、安排和开始/停止充电的命令。 |
能源产品信息 | energy_device_data | 能源实时状态、站点信息、备份历史、能源历史和充电历史。 |
能源产品设置 | energy_cmds | 更新备份储备百分比、操作模式和风暴模式等设置。 |
有用链接
OAuth服务器的元数据文件可以在以下位置找到:https://auth.tesla.cn/oauth2/v3/thirdparty/.well-known/openid-configuration。
包含这些请求的Postman集合可以在此处找到。