车辆命令
车辆命令允许你与车辆进行交互。一般来说，你必须将你的车队钥匙与车辆配对，并设置车辆命令代理以发送命令。
车辆命令代理公开了与下述相同的端点。当它接收到请求时，它会用你的钥匙签署命令，然后将请求传递给车队API。 如果命令未签署，车辆将拒绝请求并不执行任何操作。这确保了未经授权的一方无法发送命令。
注意：对于企业车辆和2021年前的S和X车型，不需要车辆命令代理。
生成车队钥匙
生成车队钥匙的步骤在车队API介绍页面 上可用。
注意：如果你已经按照设置车队遥测的步骤进行操作，那么你已经生成了车队钥匙。
配对你的钥匙
要将应用程序公钥与车辆配对：
- 确保用户已授权应用程序 并授予
vehicle_device_data或vehicle_cmds范围。 - 引导用户：
https://tesla.cn/_ak/*developer-domain.cn*
这将允许用户通过特斯拉移动应用程序将钥匙添加到他们的车辆中。
故障排除：
- 如果你收到消息称用户未授予你的第三方应用程序访问权限，请确保他们使用授权你的应用程序时使用的相同电子邮件登录特斯拉应用程序。
- 如果你收到消息称应用程序未在特斯拉注册，请确保你已为用户所在区域调用了注册端点。还需验证你的公钥仍可在
https://developer-domain.com/.well-known/appspecific/com.tesla.3p.public-key.pem访问，并在设置Range头为bytes=0-200时可被获取。
POST /api/1/vehicles/{vin}/command/actuate_trunk控制车辆的前备箱(which_trunk: "front")或者后备箱(which_trunk: "rear").
POST /api/1/vehicles/{vin}/command/cancel_software_update取消安装车辆软件更新的倒计时。车辆开始安装软件后，此操作将不再起作用。
POST /api/1/vehicles/{vin}/command/charge_max_range在最大续航里程模式下充电 -- 我们建议限制在长途旅行时使用此模式。
POST /api/1/vehicles/{vin}/command/charge_port_door_close关闭充电口盖。此命令会根据车辆状态返回错误。
电缆已连接- 车辆已插入充电电缆。非电动充电端口- 车辆未配备电动充电端口。适用于较老款的Model S和Model X车辆。已关闭- 充电端口门已关闭。
POST /api/1/vehicles/{vin}/command/charge_port_door_open打开充电口盖。此命令会根据车辆状态返回错误。
洗车模式- 车辆处于洗车模式。不允许- 车辆的驱动轴已接合或车辆未处于停车状态。
POST /api/1/vehicles/{vin}/command/charge_standard使用标准充电模式充电。如果现有充电限制请求已小于或等于标准/默认充电限制，此命令可能返回 already_started。
POST /api/1/vehicles/{vin}/command/charge_start开始车辆充电，如果车辆无法开始充电，此命令可能返回错误。
完成- 车辆已完成充电。正在充电- 车辆已在充电。未连接- 车辆未连接到充电器。无电源- 连接的充电器无法提供电源。已请求- 车辆已接收到开始充电请求。
POST /api/1/vehicles/{vin}/command/clear_pin_to_drive_admin停用PIN驾驶并重置相关PIN,车辆运行固件版本需高于2023.44。此命令仅适用于车队管理员或所有者。
POST /api/1/vehicles/{vin}/command/guest_mode- 限制访客驾驶员使用某些车辆 UI 功能:
- 驾驶员 PIN 码
- 限速模式
- 手套箱密码
- 添加/删除车辆钥匙
- 编辑车辆昵称
- 允许在车辆上擦除用户数据
- 允许用户使用车辆钥匙卡设置特斯拉手机应用程序访问权限:
- 用户使用钥匙卡解锁或认证车辆启动时，车载触摸屏将提示用户扫描二维码，将其手机设置为车辆钥匙。
- 二维码为一次性使用，10分钟后失效。
- 需要车辆固件版本 2024.14 或更高版本
- 任何扫描该二维码的账号都将能通过特斯拉应用程序访问此车辆，并且该账号的特斯拉个人资料将被下载到车内。
- 特斯拉应用程序访问权限允许用户查看车辆实时位置，发送远程指令，并且在车辆蓝牙范围内将手机设置为钥匙。
- 客人访问权限无法使用某些驾驶员访问功能，例如维修和道路救援。
- 客人访问权限会在以下情况自动移除:
- 使用钥匙卡驾驶车辆。
- 扫描新二维码（一次仅允许一位访客）。
- 客人访问权限已禁用。
- 此外，还可以使用 drivers remove api 端点远程撤销访客访问权限
- 如果用户没有安装应用程序，他们将看到此网页 (https://www.tesla.cn/_gs/test) 为了指导他们完成此过程。
POST /api/1/vehicles/{vin}/command/navigation_gps_request开始导航到给定坐标。Order 可用于指定多个停靠点的顺序。
POST /api/1/vehicles/{vin}/command/navigation_waypoints_request向车辆的导航系统发送航点列表。
POST /api/1/vehicles/{vin}/command/parental_controls_activateActivates Parental Controls with a four-digit PIN. Unlike Speed Limit Mode, parental controls allow capping speed without forcing Chill acceleration.
parental_controls_enable_settingandparental_controls_set_speed_limitfail if Parental Controls is already active. Set them before activating.- If Parental Controls is already active, this command succeeds when the PIN matches the current PIN.
If a PIN was set earlier, use that same PIN when re-enabling (for example after deactivate). Clear a stored PIN with parental_controls_clear_pin_admin before choosing a new PIN.
POST /api/1/vehicles/{vin}/command/parental_controls_clear_pin_adminClears the stored parental controls PIN without sending a PIN in the request body. This command is only accessible to fleet managers or owners.
POST /api/1/vehicles/{vin}/command/parental_controls_deactivateDeactivates Parental Controls. Requires the current four-digit PIN.
POST /api/1/vehicles/{vin}/command/parental_controls_enable_settingEnables or disables an individual parental controls setting while Parental Controls is not active. Fails with reason parental_controls_active if Parental Controls is already active — configure settings (including speed limit) before activating. Request body includes setting and enable only.
POST /api/1/vehicles/{vin}/command/parental_controls_set_speed_limitSets the parental controls speed limit in miles per hour. Enable the SpeedLimit setting with parental_controls_enable_setting while Parental Controls is not active, then activate Parental Controls when configuration is complete.
POST /api/1/vehicles/{vin}/command/remote_auto_seat_climate_request设置自动座椅加热和冷却。需要开启 预处理 或气候保持器。
POST /api/1/vehicles/{vin}/command/remote_auto_steering_wheel_heat_climate_request设置自动方向盘加热开/关。需要开启 预处理 或气候保持器。
POST /api/1/vehicles/{vin}/command/remote_seat_cooler_request设置座椅冷却。需要开启 预处理 或气候保持器。
POST /api/1/vehicles/{vin}/command/remote_seat_heater_request设置座椅加热。需要开启 预处理 或气候保持器。
POST /api/1/vehicles/{vin}/command/remote_steering_wheel_heat_level_request设置方向盘温度。需要开启 预处理 或气候保持器。
POST /api/1/vehicles/{vin}/command/remote_steering_wheel_heater_request设置方向盘加热功能的开/关。适用于不支持自动方向盘加热的车辆。需要开启 预处理 或气候保持器。
POST /api/1/vehicles/{vin}/command/remove_precondition_schedule根据 ID 删除先决条件计划。
POST /api/1/vehicles/{vin}/command/reset_pin_to_drive_pin移除驾驶的PIN。 要求车辆处于“使用pin驾驶”模式而不是“代客泊车”模式。请注意，此命令仅在PIN码未激活时有效。此命令仅适用于车队管理员或所有者。此命令必须使用Tesla车辆命令协议 - 有关更多信息，请参阅此文档。
POST /api/1/vehicles/{vin}/command/reset_valet_pin删除代客模式的PIN。要使用此命令，必须禁用代客模式。 请参阅 set_valet_mode。
POST /api/1/vehicles/{vin}/command/schedule_software_update安排将来安装的车辆软件更新的时间（无线“OTA”）。
POST /api/1/vehicles/{vin}/command/set_cabin_overheat_protection设置车辆过热保护。
POST /api/1/vehicles/{vin}/command/set_charge_limit设置车辆充电限额。This command will return already_set if the requested percent is the same as the existing charge limit.
POST /api/1/vehicles/{vin}/command/set_climate_keeper_mode启用温度保持模式。可设置的值为 0，1，2，3。分别对应 “关闭”， “保持模式”， “宠物模式”，“露营模式”
POST /api/1/vehicles/{vin}/command/set_cop_temp调节驾驶室过热保护温度(COP)。该命令不会激活COP。精确的目标温度取决于用户是否选择了C或F。可接受的值为：“0”、“1”、“2”。分别映射到低(90F/30C)、中(95F/35C)、高(100F/40C)。
POST /api/1/vehicles/{vin}/command/set_pin_to_drive设置四位数的驾驶PIN。必须先输入该PIN码，然后才能驾驶车辆。设置PIN码后，即使禁用PIN码驾驶，车辆也会记住其值，并且会丢弃使用此方法提供的任何新PIN码。要更改现有PIN，请首先调用Reset_pin_to_drive_pin。此命令必须使用Tesla车辆命令协议 - 有关更多信息，请参阅此文档。
POST /api/1/vehicles/{vin}/command/set_preconditioning_max设置空调预处理的覆盖 - 如果不使用覆盖，则它应默认为空。
POST /api/1/vehicles/{vin}/command/set_scheduled_charging从固件版本 2024.26 开始，不建议使用此端点。应改用 add charge schedule 命令。
设置充电完成的时间。 time参数是0:00过后的分钟（例如：time=120 计划在车辆当地时间凌晨 2:00 充电）
POST /api/1/vehicles/{vin}/command/set_scheduled_departure从固件版本 2024.26 开始，不建议使用此端点。应改用 add precondition schedule 命令。
设置完成出发的时间。 departure_time 和 end_off_peak_time 参数是午夜后的分钟数（例如：departure_time=120 安排车辆当地时间凌晨 2:00 出发）。
POST /api/1/vehicles/{vin}/command/set_vehicle_name更改车辆的名称。不支持访客模式。此命令必须使用Tesla车辆命令协议 - 有关更多信息，请参阅此文档。
POST /api/1/vehicles/{vin}/command/speed_limit_clear_pin_admin停用限速模式并重置相关PIN， 车辆运行固件版本需高于2023.38+。此命令仅适用于车队管理员或所有者。
POST /api/1/vehicles/{vin}/command/speed_limit_set_limit设置速度限制模式的最大速度（以英里/小时为单位）。
POST /api/1/vehicles/{vin}/command/sun_roof_control控制具有天窗功能的车辆上的天窗。
支持的状态：停止、关闭和通风。Control the sunroof on sunroof-enabled vehicles.
Supported states: stop, close, and vent.
POST /api/1/vehicles/{vin}/command/trigger_homelink打开HomeLink（用于打开和关闭车库门）。如果车辆未配备HomeLink，此命令将返回错误 not_supported。
POST /api/1/vehicles/{vin}/command/upcoming_calendar_entries即将到来的日历条目存储在车辆上。