tesla_api 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 127d7079cd952af550adb8cb746fb43826ee2eb7
-  data.tar.gz: 46c4218838c49fed63508d853c41a97a3537b532
+  metadata.gz: 18033816ec5eb77b7103295925eecef144e0c601
+  data.tar.gz: 372b7eccdcba14d8c7be82a45d3df1719f3c7ec5
 SHA512:
-  metadata.gz: 96efd5588a8bccd85e094a1a03d3df6b777115557d9d457577330ecf61c2f4c638fbc1de895a28e4ca03ed4a98fe766019c4119d08c1dbbe316173473c6d6935
-  data.tar.gz: 9d679267752007f77ba51e6eec82a128bdc4cb8d81c7bba405faaad840a6ec288937818618305a9a38c93e74bb817dd90dabafedf1392bffb2d6b0e5086298aa
+  metadata.gz: a38e04aa77bf22edc412f1d3af818b7a2f4c79255ce909e96a282808ca9441a71d42d51bc47760696b0783365fb89a4f186eb150fddec8afe2b075eb57da2af6
+  data.tar.gz: aaceed89e6cc188b2dfcf8a51c07bb3bf5158f4c86f62a978c2b20c78d94dfeae6e4d114d9ffb52a1dc1d9d1d9fe3b91863a837e6db59cd954aaf28245ad592d

data/.travis.yml

@@ -2,12 +2,14 @@ language: ruby
 rvm:
   - 1.9.3
   - 2.0.0
-  - 2.1.5
+  - 2.2.2
+  - 2.3.0
 env:
   global:
     - TESLA_EMAIL=elon.musk@teslamotors.com
     - TESLA_PASS=oilLOL
     - TESLA_CLIENT_ID=1
     - TESLA_CLIENT_SECRET=2
+    - TESLA_API_TOKEN=3
 notifications:
   email: false

data/README.md

@@ -30,7 +30,8 @@ Here's a quick example:
 ```ruby
 require 'tesla_api'
 
-tesla_api = TeslaApi::Client.new(email, password, client_id, client_secret)
+tesla_api = TeslaApi::Client.new(email, client_id, client_secret)
+tesla_api.login!(password) # Or tesla_api.token = token if you have an existing token.
 model_s = tesla_api.vehicles.first # => <TeslaApi::Vehicle>
 
 model_s.wake_up

data/Rakefile

@@ -5,4 +5,9 @@ RSpec::Core::RakeTask.new(:spec) do |task|
   task.rspec_opts = ['--color', '--format', 'documentation', '--require', 'spec_helper']
 end
 
+desc "Open an irb session preloaded with this library"
+task :console do
+  sh "irb -rubygems -I lib -r tesla_api.rb -rdotenv"
+end
+
 task default: :spec

data/apiary.apib

@@ -1,62 +1,57 @@
 FORMAT: 1A
-HOST: https://portal.vn.teslamotors.com
+HOST: https://owner-api.teslamotors.com
 
 # Tesla Model S JSON API
 This is unofficial documentation of the Tesla Model S JSON API used by the iOS and Android apps. It features functionality to monitor and control the Model S remotely.
 
-# Group Authentication Flow
-These endpoints handle login and session management
+# Group Authentication
 
-## GET /login
-Returns the login form. Sets a `_s_portal_session` cookie for the session
-+ Response 200
+## Tokens [/oauth/token]
 
-    + Headers
-
-            Set-Cookie: _s_portal_session={cookie}; path=/; secure; HttpOnly
-
-    + Body
+### Get an Access Token [POST]
+Performs the login. Takes in an plain text email and password, matching the owner's login information for [https://my.teslamotors.com/user/login](https://my.teslamotors.com/user/login).
 
-            Login Screen HTML
+Returns a `access_token` which is passed along as a header with all future requests to authenticate the user.
 
-## POST /login
-Performs the login. Takes in an plain text email and password, matching the owner's login from [http://teslamotors.com/mytesla](http://teslamotors.com/mytesla).
+You must provide the `Authorization: Bearer {access_token}` header in all other requests.
 
-Sets a `user_credentials` cookie that expires in 3 months, which is passed along with all future requests to authenticate the user.
+The current client ID and secret are [available here](http://pastebin.com/fX6ejAHd)
 
-Redirects back to a dummy welcome page. This page is ignored by the smartphone app and can be ignored by your API client.
-+ Request (application/x-www-form-urlencoded)
++ Parameters
+    + grant_type: `password` (string) - The type of oAuth grant. Always "password"
+    + client_id: `abc` (string) - The oAuth client ID
+    + client_secret: `123` (string) - The oAuth client secret
+    + email: `elon@teslamotors.com` (string) - The email for my.teslamotors.com
+    + password: `edisonsux` (string) - The password for my.teslamotors.com
 
++ Response 200 (application/json)
     + Body
 
-            user_session%5Bemail%5D=string&user_session%5Bpassword%5D=string
-
-+ Response 302
-
-    + Headers
-
-            Set-Cookie: _s_portal_session={cookie}; path=/; secure; HttpOnly
-            Set-Cookie: user_credentials=x; path=/; expires=Fri, 03-May-2013 03:01:54 GMT; secure; HttpOnly
-            Location: https://portal.vn.teslamotors.com/
-
+            {
+              "access_token": "abc123",
+              "token_type": "bearer",
+              "expires_in": 7776000
+            }
 
-    + Body
+# Group Vehicles
+A logged in user can have multiple vehicles under their account. This resource is primarily responsible for listing the vehicles and the basic details about them.
 
-            Dummy Welcome Page
+## Vehicle Collection [/api/1/vehicles]
 
+### List all Vehicles [GET]
+Retrieve a list of your owned vehicles (includes vehicles not yet shipped!)
 
-# Group Vehicle List
-A logged in user can have multiple vehicles under their account. This resource is primarily responsible for listing the vehicles and the basic details about them.
++ Request
+    + Headers
 
-Must have a `_s_portal_session` and `user_credentials` cookie set for all requests.
+            Authorization: Bearer {access_token}
 
-## GET /vehicles
-Retrieve a list of your owned vehicles (includes vehicles not yet shipped!)
 + Response 200 (application/json)
 
     + Body
 
-            [{
+            {
+              "response": [{
                 "color": null,
                 "display_name": null,
                 "id": 321,
@@ -66,40 +61,56 @@ Retrieve a list of your owned vehicles (includes vehicles not yet shipped!)
                 "vin": "5YJSA1CN5CFP01657",
                 "tokens": ["x", "x"],
                 "state": "online"
-            }]
+              }],
+              "count":1
+            }
 
 
-# Group Vehicle Status
+## State and Settings [/api/1/vehicles/{vehicle_id}]
 These resources are read-only and determine the state of the vehicle's various sub-systems.
 
-Must have a `_s_portal_session` and `user_credentials` cookie set for all requests.
++ Parameters
 
-## GET /vehicles/{id}/mobile_enabled
+    + vehicle_id: `1` (number) - The id of the Vehicle.
+
+## Mobile Access [GET /api/1/vehicles/{vehicle_id}/mobile_enabled]
 Determines if mobile access to the vehicle is enabled.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-                "reason":"",
-                "result":true
+                "response": true
             }
 
-## GET /vehicles/{id}/command/charge_state
+## Charge State [GET /api/1/vehicles/{vehicle_id}/data_request/charge_state]
 Returns the state of charge in the battery.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
+              "response": {
                 "charging_state": "Complete",  // "Charging", ??
                 "charge_to_max_range": false,  // current std/max-range setting
                 "max_range_charge_counter": 0,
@@ -118,19 +129,27 @@ Returns the state of charge in the battery.
                 "time_to_full_charge": null,   // valid only while charging
                 "charge_rate": -1.0,           // float mi/hr charging or -1 if not charging
                 "charge_port_door_open": true
+              }
             }
 
-## GET /vehicles/{id}/command/climate_state
+## Climate Settings [GET /api/1/vehicles/{vehicle_id}/data_request/climate_state]
 Returns the current temperature and climate control state.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
+              "response": {
                 "inside_temp": 17.0,          // degC inside car
                 "outside_temp": 9.5,          // degC outside car or null
                 "driver_temp_setting": 22.6,  // degC of driver temperature setpoint
@@ -139,56 +158,80 @@ Returns the current temperature and climate control state.
                 "is_front_defroster_on": null, // null or boolean as integer?
                 "is_rear_defroster_on": false,
                 "fan_status": 0               // fan speed 0-6 or null
+              }
             }
 
-## GET /vehicles/{id}/command/drive_state
+## Driving and Position [GET /api/1/vehicles/{vehicle_id}/data_request/drive_state]
 Returns the driving and position state of the vehicle.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
+              "response": {
                 "shift_state": null,          //
                 "speed": null,                //
                 "latitude": 33.794839,        // degrees N of equator
                 "longitude": -84.401593,      // degrees W of the prime meridian
                 "heading": 4,                 // integer compass heading, 0-359
                 "gps_as_of": 1359863204       // Unix timestamp of GPS fix
+              }
             }
 
-## GET /vehicles/{id}/command/gui_settings
+## GUI Settings [GET /api/1/vehicles/{vehicle_id}/data_request/gui_settings]
 Returns various information about the GUI settings of the car, such as unit format and range display.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
+              "response": {
                 "gui_distance_units": "mi/hr",
                 "gui_temperature_units": "F",
                 "gui_charge_rate_units": "mi/hr",
                 "gui_24_hour_time": false,
                 "gui_range_display": "Rated"
+              }
             }
 
-## GET /vehicles/{id}/command/vehicle_state
+## Vehicle State [GET /api/1/vehicles/{vehicle_id}/data_request/vehicle_state]
 Returns the vehicle's physical state, such as which doors are open.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
+              "response": {
                 "df": false,                  // driver's side front door open
                 "dr": false,                  // driver's side rear door open
                 "pf": false,                  // passenger's side front door open
@@ -205,229 +248,464 @@ Returns the vehicle's physical state, such as which doors are open.
                 "has_spoiler": false,         // spoiler is installed
                 "roof_color": "Colored",      // "None" for panoramic roof
                 "perf_config": "Base"
+              }
             }
 
 # Group Vehicle Commands
 These commands alter the vehicles state, and return result (true/false) to indicate success, and if failure reason contains the cause of failure.
 
-Must have a `_s_portal_session` and `user_credentials` cookie set for all requests.
+## Wake Up Car [POST /api/1/vehicles/{vehicle_id}/wake_up]
+Wakes up the car from the sleep state. Necessary to get some data from the car.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
++ Parameters
+
+    + vehicle_id: `1` (number) - The id of the Vehicle.
+
++ Response 200 (application/json)
+
+    + Body
+
+            {
+              "response": {
+                "result": true,
+                "reason": ""
+              }
+            }
+
+## Set Valet Mode [POST /api/1/vehicles/{vehicle_id}/command/set_valet_mode]
+Sets valet mode on or off with a PIN to disable it from within the car. Reuses last PIN from previous valet session.
+Valet Mode limits the car's top speed to 70MPH and 80kW of acceleration power. It also disables Homelink, Bluetooth and
+Wifi settings, and the ability to disable mobile access to the car. It also hides your favorites, home, and work
+locations in navigation.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
++ Parameters
+
+    + vehicle_id: `1` (number) - The id of the Vehicle.
+    + on: true (boolean) - Whether to enable or disable valet mode.
+    + password: 1234 (number) - (optional) A 4 digit PIN code to unlock the car.
+
++ Response 200 (application/json)
+
+    + Body
+
+            {
+              "response": {
+                "result": true,
+                "reason": ""
+              }
+            }
+
+## Reset Valet PIN [POST /api/1/vehicles/{vehicle_id}/command/reset_valet_pin]
+Resets the PIN set for valet mode, if set.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
++ Parameters
+
+    + vehicle_id: `1` (number) - The id of the Vehicle.
+
++ Response 200 (application/json)
+
+    + Body
+
+            {
+              "response": {
+                "result": true,
+                "reason": ""
+              }
+            }
+
+## Open Charge Port [POST /api/1/vehicles/{vehicle_id}/command/charge_port_door_open]
+Opens the charge port. Does not close the charge port (for now...)
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
 
-## GET /vehicles/{id}/command/charge_port_door_open
-Open the charge port.
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": true,
+                "reason": ""
+              }
             }
 
-## GET /vehicles/{id}/command/charge_standard
-Set the charge mode to standard (~90% under the new percentage system introduced in 4.5).
+## Set Charge Limit to Standard [POST /api/1/vehicles/{vehicle_id}/command/charge_standard]
+Set the charge mode to standard (90% under the new percentage system introduced in 4.5).
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": false,
+                "reason": "already_standard"
+              }
             }
 
-## GET /vehicles/{id}/command/charge_max_range
-Set the charge mode to max range (100% under the new percentage system introduced in 4.5).
+## Set Charge Limit to Max Range [POST /api/1/vehicles/{vehicle_id}/command/charge_max_range]
+Set the charge mode to max range (100% under the new percentage system introduced in 4.5). Use sparingly!
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": false,
+                "reason": "already_max_range"
+              }
             }
 
-## GET /vehicles/{id}/command/set_charge_limit?percent={limit_value}
+## Set Charge Limit [POST /api/1/vehicles/{vehicle_id}/command/set_charge_limit?percent={limit_value}]
 Set the charge limit to a custom percentage.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
-    + limit_value (number) ... The percentage value
+    + vehicle_id: `1` (number) - The id of the Vehicle.
+    + limit_value: `75` (number) - The percentage value
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": true,
+                "reason": ""
+              }
             }
 
-## GET /vehicles/{id}/command/charge_start
-Start charging.
+## Start Charging [POST /api/1/vehicles/{vehicle_id}/command/charge_start]
+Start charging. Must be plugged in, have power available, and not have reached your charge limit.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason" // "already started" if a charge is in progress
+              "response": {
+                "result": true,
+                "reason": "" // "already_started" if a charge is in progress
+              }
             }
 
-## GET /vehicles/{id}/command/charge_stop
-Stop charging.
+## Stop Charging [POST /api/1/vehicles/{vehicle_id}/command/charge_stop]
+Stop charging. Must already be charging.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason" // "not_charging" if a charge was not in progress
+              "response": {
+                "result": true,
+                "reason": "" // "not_charging" if a charge was not in progress
+              }
             }
 
-## GET /vehicles/{id}/command/flash_lights
+## Flash Lights [POST /api/1/vehicles/{vehicle_id}/command/flash_lights]
 Flash the lights once.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": true,
+                "reason": ""
+              }
             }
 
-## GET /vehicles/{id}/command/honk_horn
+## Honk Horn [POST /api/1/vehicles/{vehicle_id}/command/honk_horn]
 Honk the horn once.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": true,
+                "reason": ""
+              }
             }
 
-## GET /vehicles/{id}/command/door_unlock
+## Unlock Doors [POST /api/1/vehicles/{vehicle_id}/command/door_unlock]
 Unlock the car's doors.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": true,
+                "reason": ""
+              }
             }
 
-## GET /vehicles/{id}/command/door_lock
+## Lock Doors [POST /api/1/vehicles/{vehicle_id}/command/door_lock]
 Lock the car's doors.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": true,
+                "reason": ""
+              }
             }
 
-## GET /vehicles/{id}/command/set_temps?driver_temp={driver_degC}&passenger_temp={pass_degC}
+## Set Temperature [POST /api/1/vehicles/{vehicle_id}/command/set_temps?driver_temp={driver_degC}&passenger_temp={pass_degC}]
 Set the temperature target for the HVAC system.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
-    + driver_degC (number) ... The desired temperature on the driver's side in celcius.
-    + pass_degC (number) ... The desired temperature on the passenger's side in celcius.
+    + vehicle_id: `1` (number) - The id of the Vehicle.
+    + driver_degC: `23.7` (number) - The desired temperature on the driver's side in celcius.
+    + pass_degC: `18.1` (number) - The desired temperature on the passenger's side in celcius.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": true,
+                "reason": ""
+              }
             }
 
-## GET /vehicles/{id}/command/auto_conditioning_start
+## Start Air Condition [POST /api/1/vehicles/{vehicle_id}/command/auto_conditioning_start]
 Start the HVAC system. Will cool or heat automatically, depending on set temperature.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": true,
+                "reason": ""
+              }
             }
 
-## GET /vehicles/{id}/command/auto_conditioning_stop
+## Stop Air Condition [POST /api/1/vehicles/{vehicle_id}/command/auto_conditioning_stop]
 Stop the HVAC system.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
+    + vehicle_id: `1` (number) - The id of the Vehicle.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": true,
+                "reason": ""
+              }
             }
 
-## GET /vehicles/{id}/command/sun_roof_control?state={state}
+## Move Pano Roof [POST /api/1/vehicles/{vehicle_id}/command/sun_roof_control?state={state}&percent={percent}]
 Controls the car's panoramic roof, if installed.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
 + Parameters
 
-    + id (number) ... The ID number of the car
-    + state (string)
+    + vehicle_id: `1` (number) - The id of the Vehicle.
+    + state: `open` (enum[string])
         The desired state of the panoramic roof. The approximate percent open values for each state are `open` = 100%, `close` = 0%, `comfort` = 80%, and `vent` = ~15%
-        + Values
-            + `open`
-            + `close`
-            + `comfort`
-            + `vent`
+        + Members
+            + `open` - Open the roof fully
+            + `close` - Close the roof completely
+            + `comfort` - Open to the comfort (80%) setting
+            + `vent` - Open the roof to the vent (~15%) setting
+            + `move` - Indicates you will provide a percentage to move the roof.
+    + percent: `50` (number, optional) - The percentage to move the roof to.
+
++ Response 200 (application/json)
+
+    + Body
+
+            {
+              "response": {
+                "result": true,
+                "reason": ""
+              }
+            }
+
+## Remote Start [POST /api/1/vehicles/{vehicle_id}/command/remote_start_drive?password={password}]
+Start the car for keyless driving. Must start driving within 2 minutes of issuing this request.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
++ Parameters
+
+    + vehicle_id: `1` (number) - The id of the Vehicle.
+    + password: `edisonsux` (string) - The password to the authenticated my.teslamotors.com account.
+
++ Response 200 (application/json)
+
+    + Body
+
+            {
+              "response": {
+                "result": true,
+                "reason": ""
+              }
+            }
+
+## Open Trunk/Frunk [POST /api/1/vehicles/{vehicle_id}/command/trunk_open]
+Open the trunk or frunk. Currently inoperable.
+
++ Request
+    + Headers
+
+            Authorization: Bearer {access_token}
+
++ Parameters
+
+    + vehicle_id: `1` (number) - The id of the Vehicle.
+    + which_trunk: `rear` (string) - The trunk to open. `rear` is the only one known currently.
 
 + Response 200 (application/json)
 
     + Body
 
             {
-              "result": false,
-              "reason": "failure reason"
+              "response": {
+                "result": true,
+                "reason": ""
+              }
             }