身份验证
API 端点需要身份验证令牌。它必须包含在标题中
Authorization: Bearer <token>
令牌类型
代币有两种类型,每种类型都有不同的用途。
- 第三方令牌:代表第三方应用程序代个人访问API或产品的令牌。:
- 第三方开发者构建的移动应用程序或服务,用于与个人拥有的车辆或 Powerwall 进行交互。
- 业余爱好者构建的与其自有特斯拉产品集成的应用程序。
- 合作伙伴令牌:代表应用程序或企业的令牌。示例:
范围
范围用于限制API访问仅限于您的应用程序所需的数据。
| 名称 | 范围 | 描述 |
|---|---|---|
| 使用特斯拉登录 | openid | 允许特斯拉客户使用其特斯拉凭据登录应用程序。 |
| 刷新令牌 | offline_access | 允许获取刷新令牌而无需用户再次登录。 |
| 个人资料信息 | user_data | 联系信息、家庭地址、个人资料图片和推荐信息。 |
| 车辆信息 | vehicle_device_data | 允许访问您车辆的实时数据、服务历史记录、服务计划数据、服务通信、符合条件的升级、附近的超级充电站和所有权详细信息。 |
| 车辆位置 | vehicle_location | 允许访问您的车辆位置信息,包括精确位置等数据以及粗略位置等近似位置服务。 |
| 车辆命令 | vehicle_cmds | 添加/删除司机、访问实时摄像头、解锁、唤醒、远程启动和安排软件更新等命令。 |
| 车辆充电管理 | vehicle_charging_cmds | 车辆充电历史、账单金额、充电地点、安排和开始/停止充电的命令。 |
| 车辆规格 | vehicle_specs | 访问详细的车辆规格。此权限范围仅限合作伙伴令牌使用(请参阅合作伙伴令牌)。 |
| 能源产品信息 | energy_device_data | 能源实时状态、站点信息、备份历史、能源历史和充电历史。 |
| 能源产品设置 | energy_cmds | 更新备份储备百分比、操作模式和风暴模式等设置。 |
| 企业管理 | enterprise_management | 允许企业访问企业管理相关功能。 |
有用链接
OAuth服务器的元数据文件可以在以下位置找到:https://auth.tesla.cn/oauth2/v3/thirdparty/.well-known/openid-configuration。
包含这些请求的Postman集合可以在此处找到。