开发者Skip to main content

  1. 文件
  2. 收费

身份验证

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

Authorization: Bearer <token>

令牌类型

有三种类型的令牌,每种令牌用于不同的目的。识别适合您的应用程序的正确令牌类型非常重要。否则,您可能无法从API收到预期的响应。

选择最符合您使用案例的令牌类型。

  1. 我是开发人员,正在基于Fleet API构建闭源软件。我将访问用户的帐户: 第三方令牌
  2. 我有一个注册的Tesla for Business帐户,并希望与我公司的特斯拉产品进行互动: 合作伙伴令牌
    • 如果您是企业并希望自助注册Tesla for Business,请访问自助注册页面
  3. 我是一个爱好者,想与自己的特斯拉产品进行互动: 第三方令牌
  4. 我希望调用合作伙伴端点页面上的端点: 合作伙伴令牌

范围

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