身份验证
API 端点需要身份验证令牌。它必须包含在标题中
Authorization: Bearer <token>
令牌类型
有三种类型的令牌,每种令牌用于不同的目的。识别适合您的应用程序的正确令牌类型非常重要。否则,您可能无法从API收到预期的响应。
选择最符合您使用案例的令牌类型。
- 我是开发人员,正在基于Fleet API构建闭源软件。我将访问用户的帐户: 第三方令牌。
 - 我有一个注册的Tesla for Business帐户,并希望与我公司的特斯拉产品进行互动: 合作伙伴令牌。
- 如果您是企业并希望自助注册Tesla for Business,请访问自助注册页面。
 
 - 我是一个爱好者,想与自己的特斯拉产品进行互动: 第三方令牌。
 - 我希望调用合作伙伴端点页面上的端点: 合作伙伴令牌。
 
范围
范围用于限制API访问仅限于您的应用程序所需的数据。
| 名称 | 范围 | 描述 | 
|---|---|---|
| 使用特斯拉登录 | openid | 允许特斯拉客户使用其特斯拉凭据登录应用程序。 | 
| 刷新令牌 | offline_access | 允许获取刷新令牌而无需用户再次登录。 | 
| 个人资料信息 | user_data | 联系信息、家庭地址、个人资料图片和推荐信息。 | 
| 车辆信息 | vehicle_device_data | 允许访问您车辆的实时数据、服务历史记录、服务计划数据、服务通信、符合条件的升级、附近的超级充电站和所有权详细信息。 | 
| 车辆位置 | 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集合可以在此处找到。