开发者Skip to main content

  1. 文件
  2. 收费

身份验证

API 端点需要身份验证令牌。它必须包含在标题中

Authorization: Bearer <token>

令牌类型

代币有两种类型,每种类型都有不同的用途。

  1. 第三方令牌:代表第三方应用程序代个人访问API或产品的令牌。:
    • 第三方开发者构建的移动应用程序或服务,用于与个人拥有的车辆或 Powerwall 进行交互。
    • 业余爱好者构建的与其自有特斯拉产品集成的应用程序。
  2. 合作伙伴令牌:代表应用程序或企业的令牌。示例:
    • 自动化与其自有车队交互的企业。企业可以通过访问自助注册页面自行注册 Tesla for Business。
    • 对其自有应用程序进行配置更改的开发者。
    • 所有对合作伙伴端点的调用。

范围

范围用于限制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集合可以在此处找到。