tesla_api 3.0.4 → 3.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc39a9565be19773d6cb2e07f625fc6f6d1a7472ba4dbc7d77da49b01d8daff7
-  data.tar.gz: 2cb34e0686652e67aa6ed566714723206c184f330be632dd484300b618d51e52
+  metadata.gz: 321a3deb2934f51a38bc1f3d427ceb123ebe2b8af3f5c7bba6453d66aedf40ab
+  data.tar.gz: a751ba87102749678d1ceb57e711050a19556344399c8da01adb06342c421802
 SHA512:
-  metadata.gz: ff4c6fe5947a94979fba783e275870fe8fe4e55aa8525f4d8b1e8cd841bc7c4012be098b3bef66152103122fcb1c11ef7556ad0409e5183fa7dd5a07854647b3
-  data.tar.gz: ab9903e449f7bcdfc8afca85fa6bfba69fccdb5b27e3a10c16ceae08633ed5c799df8ab04af7b4b99f0969ba81d2d7cd1e67a81787d3f9bb0c3244fda1c0e70c
+  metadata.gz: 134fc9efde3baf7d3d9b07d1bfe94f984a5c74799cd1c391f4df6bef6f718494da715b72a465d8e767dc04d15e5b49f659f4ecbb347bc52bebca69963b29d809
+  data.tar.gz: 2422bbf4044c8887d89f3d30a79cebf8e01eff9f0c9e544e87ac07bb1f9edd84b69b2f8b0916963347460436db8064a99dfe9299e259856b221b68fde3e100e4

data/docs/README.md

@@ -1,6 +1,6 @@
 # Introduction
 
-This is unofficial documentation of the Tesla JSON API used by their iOS and Android apps. It features functionality to monitor and control their vehicle (Model S, Model X, and Model 3) and power (Powerwall) products. We currently have documentation for their vehicles, but always accept [pull requests](https://github.com/timdorr/tesla-api/pulls) for improvements and additions.
+This is unofficial documentation of the Tesla JSON API used by their iOS and Android apps. It features functionality to monitor and control their vehicle (Models S, 3, X, Y) and power (Powerwall) products. We currently have documentation for their vehicles, but always accept [pull requests](https://github.com/timdorr/tesla-api/pulls) for improvements and additions.
 
 ## Before You Begin
 

data/docs/api-basics/vehicles.md

@@ -35,7 +35,7 @@ Retrieve a list of your owned vehicles (includes vehicles not yet shipped!)
       "in_service": false,
       "id_s": "12345678901234567",
       "calendar_enabled": true,
-      "api_version": 4,
+      "api_version": 7,
       "backseat_token": null,
       "backseat_token_updated_at": null
     }
@@ -50,9 +50,9 @@ These resources are read-only and determine the state of the vehicle's various s
 
 ### URL parameters
 
-| Field | Example | Description |
-| :--- | :--- | :--- |
-| `id` | `12345678901234567` | The `id` of the car. (Not the `vehicle_id`!) |
+| Field | Example             | Description                                  |
+| :---- | :------------------ | :------------------------------------------- |
+| `id`  | `12345678901234567` | The `id` of the car. (Not the `vehicle_id`!) |
 
 ### Response
 
@@ -70,10 +70,9 @@ These resources are read-only and determine the state of the vehicle's various s
     "in_service": false,
     "id_s": "12345678901234567",
     "calendar_enabled": true,
-    "api_version": 4,
+    "api_version": 7,
     "backseat_token": null,
     "backseat_token_updated_at": null
   }
 }
 ```
-

data/docs/miscellaneous/endpoints.md

@@ -1,6 +1,6 @@
 # Endpoints File
 
-This the latest contents of the ownerapi_endpoints.json file from the 3.10.0 version of the app.
+This the latest contents of the ownerapi_endpoints.json file from the 3.10.2 version of the app.
 
 ```json
 {
@@ -329,7 +329,7 @@ This the latest contents of the ownerapi_endpoints.json file from the 3.10.0 ver
     "URI": "api/1/vehicles/{vehicle_id}/eligible_upgrades",
     "AUTH": true
   },
-  "AUTOPILOT_UPGRADE_URL": {
+  "UPGRADE_URL": {
     "TYPE": "GET",
     "URI": "api/1/vehicles/{vehicle_id}/purchase_url",
     "AUTH": true
@@ -445,6 +445,11 @@ This the latest contents of the ownerapi_endpoints.json file from the 3.10.0 ver
     "URI": "api/1/energy_sites/{site_id}/backup",
     "AUTH": true
   },
+  "OFF_GRID_VEHICLE_CHARGING_RESERVE": {
+    "TYPE": "POST",
+    "URI": "api/1/energy_sites/{site_id}/off_grid_vehicle_charging_reserve",
+    "AUTH": true
+  },
   "SITE_NAME": {
     "TYPE": "POST",
     "URI": "api/1/energy_sites/{site_id}/site_name",

data/docs/vehicle/commands/climate.md

@@ -30,6 +30,8 @@ Stop the climate control (HVAC) system.
 
 Sets the target temperature for the climate control (HVAC) system.
 
+Note: Despite accepting two parameters, only the `driver_temp` will be used to set the target temperature. 
+
 Note: The parameters are always in celsius, regardless of the region the car is in or the display settings of the car.
 
 ### Parameters

data/docs/vehicle/commands/homelink.md

@@ -8,7 +8,7 @@ Opens or closes the primary Homelink device. The provided location must be in pr
 
 | Parameter | Example            | Description        |
 | :-------- | :----------------- | :----------------- |
-| lat       | 36.98765432109876  | Current lattitude. |
+| lat       | 36.98765432109876  | Current latitude. |
 | lon       | -77.12345678901234 | Current longitude. |
 
 ### Response

data/docs/vehicle/commands/sharing.md

@@ -4,7 +4,7 @@
 
 Sends a location for the car to start navigation or play a video in theatre mode.
 
-These docs take from the Android app, which sends the data in JSON form. However, a urlencoded POST body will work as well. The basic format to a request looks like this:
+These docs take from the Android app, which sends the data in JSON form. However, a [URL-encoded](https://en.wikipedia.org/wiki/Percent-encoding) POST body will work as well. The basic format to a request looks like this:
 
 ```json
 {
@@ -24,7 +24,7 @@ Note: This API was previously `navigation_request`, but has been updated to supp
 | Parameter                        | Example                     | Description                                                    |
 | :------------------------------- | :-------------------------- | :------------------------------------------------------------- |
 | type                             | share_ext_content_raw       | Must be `share_ext_content_raw`.                               |
-| locale                           | en-US                       | The locale for the navigation request.                         |
+| locale                           | en-US                       | The locale for the navigation request. [ISO 639-1 standard language codes](https://www.andiamo.co.uk/resources/iso-language-codes/)                        |
 | timestamp_ms                     | 1539465730                  | The current UNIX timestamp.                                    |
 | value[android.intent.extra.TEXT] | 123 Main St, City, ST 12345 | The address or video URL to set as the navigation destination. |
 

data/docs/vehicle/commands/valet.md

@@ -4,16 +4,18 @@ Valet Mode limits the car's top speed to 70MPH and 80kW of acceleration power. I
 Wifi settings, and the ability to disable mobile access to the car. It also hides your favorites, home, and work
 locations in navigation.
 
+Note: the `password` parameter isn't required to turn on or off Valet Mode, even with a previous PIN set. If you clear the PIN and activate Valet Mode without the parameter, you will only be able to deactivate it from your car's screen by signing into your Tesla account. 
+
 ## POST `/api/1/vehicles/{id}/command/set_valet_mode`
 
 Activates or deactivates Valet Mode.
 
 ### Parameters
 
-| Parameter | Example | Description                                                                       |
-| :-------- | :------ | :-------------------------------------------------------------------------------- |
-| on        | true    | true to activate, false to deactivate. Must include previous PIN if deactivating. |
-| password  | 1234    | A PIN to deactivate Valet Mode. Can be blank if activating with a previous PIN.   |
+| Parameter | Example | Description                                                                     |
+| :-------- | :------ | :------------------------------------------------------------------------------ |
+| on        | true    | true to activate, false to deactivate.                                          |
+| password  | 1234    | A PIN to deactivate Valet Mode. Please see note about the `password` parameter. |
 
 ### Response
 
@@ -26,7 +28,7 @@ Activates or deactivates Valet Mode.
 
 ## POST `/api/1/vehicles/{id}/command/reset_valet_pin`
 
-Clears the currently set PIN for Valet Mode when deactivated. A new PIN will be required when activating again.
+Clears the currently set PIN for Valet Mode when deactivated. A new PIN will be required when activating from the car screen. See the note above about activating via the API without a PIN set.
 
 ### Response
 

data/docs/vehicle/commands/wake.md

@@ -4,6 +4,9 @@
 
 Wakes up the car from a sleeping state.
 
+The API will return a response immediately, however it could take several seconds before the car is actually online and ready to receive other commands.
+One way to deal with this is to call this endpoint in a loop until the returned state says "online", with a timeout to give up. In some cases, the wake up can be slow, so consider using a timeout of atleast 30 seconds.
+
 ### Response
 
 ```json
@@ -21,7 +24,7 @@ Wakes up the car from a sleeping state.
     "in_service": false,
     "id_s": "12345678901234567",
     "calendar_enabled": true,
-    "api_version": 4,
+    "api_version": 7,
     "backseat_token": null,
     "backseat_token_updated_at": null
   }

data/docs/vehicle/commands/windows.md

@@ -4,13 +4,17 @@
 
 Controls the windows. Will vent or close all windows simultaneously.
 
+`lat` and `lon` values must be near the current location of the car for
+`close` operation to succeed.  For `vent`, the `lat` and `lon` values are
+ignored, and may both be `0` (which has been observed from the app itself).
+
 ### Parameters
 
 | Parameter | Example | Description                                                                 |
 | :-------- | :------ | :-------------------------------------------------------------------------- |
 | command   | close   | What action to take with the windows. Allows the values `vent` and `close`. |
-| lat       | 0       | Seems to not care what this is, 0 is the only value sent by the app.        |
-| lon       | 0       | Seems to not care what this is, 0 is the only value sent by the app.        |
+| lat       | 0       | Your current latitude.  See Notes above.                                    |
+| lon       | 0       | Your current longitude.  See Notes above.                                   |
 
 ### Response
 

data/docs/vehicle/optioncodes.md

@@ -10,6 +10,9 @@ edit this page and submit a_
 [_pull request_](https://github.com/timdorr/tesla-api/pulls)_. It is much
 appreciated!_
 
+**As of August 2019, Option Codes cannot be relied on.** Vehicles now
+return a generic set of codes related to a Model 3.
+
 | Code | Title | Description |
 | :--- | :--- | :--- |
 | MDLS | Model S | This vehicle is a Model S | 
@@ -59,7 +62,7 @@ appreciated!_
 | BC0B | Black Brake Calipers | | 
 | BC0R | Red Brake Calipers | |
 | BC3B | Black Brake Calipers, Model 3 | |
-| BCMB | Black Brake Calipers | | 
+| BCMB | Black Brake Calipers, Mando Brakes | | 
 | BCYR | Performance Brakes | |
 | BG30 | No Badge | Model 3 |
 | BP00 | No Ludicrous | | 
@@ -205,7 +208,7 @@ appreciated!_
 | PF01 | Performance Legacy Package | | 
 | PI00 | No Premium Interior | | 
 | PI01 | Premium Upgrades Package | | 
-| PK00 | Parking Sensors | | 
+| PK00 | Parking Sensors | No Parking Sensors | 
 | PMAB | Anza Brown Metallic Color | | 
 | PMBL | Obsidian Black Multi-Coat Color | | 
 | PMMB | Monterey Blue Metallic Color | | 
@@ -288,14 +291,15 @@ appreciated!_
 | STY5S | Five Seat Interior | |
 | STY7S | Seven Seat Interior | |
 | SU00 | Standard Suspension | | 
-| SU01 | Smart Air Suspension | | 
+| SU01 | Smart Air Suspension | |
+| SU03 | Suspension	Suspension Update | Model X 2020 |
 | SU3C | Suspension | Coil spring suspension |
 | T3MA | Tires M3 | 18 Michelin All Season, Square |
 | TIC4 | Tires | All-Season Tires | 
 | TIG2 | Summer Tires | |
 | TIM7 | Summer Tires | |
 | TIMP | Tires | Michelin Primacy 19" Tire |
-| TIP0 | All-season Tires | |
+| TIP0 | All-season Tires | Pirelli Scorpion Zero Asimmetrico 22” Tire |
 | TM00 | Model Trim | General Production Series Vehicle | 
 | TM02 | General Production Signature Trim | | 
 | TM0A | ALPHA PRE-PRODUCTION NON-SALEABLE | | 
@@ -323,6 +327,7 @@ appreciated!_
 | SPT31 | Performance Upgrade | Model 3 |
 | SPTY1 | Performance Upgrade | Model Y |
 | W32P | 20" Performance Wheels | Model 3 |
+| W32D | 20" Gray Performance Wheels | Model 3 |
 | W38B | 18" Aero Wheels | For the Model 3 and Model Y |
 | W39B | 19" Sport Wheels | | 
 | WR00 | No Wrap | |
@@ -341,7 +346,7 @@ appreciated!_
 | WTSS | 21" Turbine Wheels | | 
 | WTTB | 19" Cyclone Wheels | | 
 | WTTC | 21" Sonic Carbon Twin Turbine Wheels | |
-| WTUT | 22" Onyx Black Wheels | |
+| WTUT | 22" Onyx Black Wheels | 22" Ultrasonic Turbine wheels |
 | WTW2 | 19" Nokian Winter Wheel Set | |
 | WTW3 | 19" Pirelli Winter Wheel Set | |
 | WTW4 | 19" Winter Tire Set | | 
@@ -366,7 +371,7 @@ appreciated!_
 | X001 | Override: Power Liftgate | | 
 | X003 | Maps & Navigation | | 
 | X004 | Override: No Navigation | | 
-| X007 | Daytime running lights | | 
+| X007 | Exterior Lights	Override: Premium exterior lighting YES | | 
 | X010 | Base Mirrors | | 
 | X011 | Override: Homelink | | 
 | X012 | Override: No Homelink | | 
@@ -377,6 +382,7 @@ appreciated!_
 | X021 | No Rear Carbon Fiber Spoiler | |
 | X024 | Performance Package | | 
 | X025 | Performance Powertrain | | 
+| X026 | Door handle | No light handle |
 | X027 | Lighted Door Handles | Light handle | 
 | X028 | Battery Badge | Normal Badging | 
 | X029 | Remove Battery Badge | | 

data/docs/vehicle/state/chargestate.md

@@ -43,6 +43,7 @@ Information on the state of charge in the battery and its various settings.
     "managed_charging_start_time": null,
     "managed_charging_user_canceled": false,
     "max_range_charge_counter": 0,
+    "minutes_to_full_charge": 0,
     "not_enough_power_to_heat": false,
     "scheduled_charging_pending": false,
     "scheduled_charging_start_time": null,

data/docs/vehicle/state/climatestate.md

@@ -12,6 +12,7 @@ Information on the current internal temperature and climate control system.
     "battery_heater": false,
     "battery_heater_no_power": false,
     "climate_keeper_mode": "dog",
+    "defrost_mode": 0,
     "driver_temp_setting": 21.6,
     "fan_status": 0,
     "inside_temp": null,
@@ -35,7 +36,6 @@ Information on the current internal temperature and climate control system.
     "seat_heater_rear_right_back": 0,
     "seat_heater_right": 2,
     "side_mirror_heaters": false,
-    "smart_preconditioning": false,
     "steering_wheel_heater": false,
     "timestamp": 1543187641727,
     "wiper_blade_heater": false

data/docs/vehicle/state/data.md

@@ -4,7 +4,7 @@
 
 A rollup of all the `data_request` endpoints plus vehicle configuration.
 
-*Note:* all `*_range` values are in miles, irrespective of GUI configuration.
+_Note:_ all `*_range` values are in miles, irrespective of GUI configuration.
 
 ### Response
 
@@ -23,7 +23,7 @@ A rollup of all the `data_request` endpoints plus vehicle configuration.
     "in_service": false,
     "id_s": "12345678901234567",
     "calendar_enabled": true,
-    "api_version": 6,
+    "api_version": 7,
     "backseat_token": null,
     "backseat_token_updated_at": null,
     "drive_state": {
@@ -44,6 +44,7 @@ A rollup of all the `data_request` endpoints plus vehicle configuration.
       "battery_heater": false,
       "battery_heater_no_power": false,
       "climate_keeper_mode": "dog",
+      "defrost_mode": 0,
       "driver_temp_setting": 21.6,
       "fan_status": 0,
       "inside_temp": null,
@@ -67,7 +68,6 @@ A rollup of all the `data_request` endpoints plus vehicle configuration.
       "seat_heater_rear_right_back": 0,
       "seat_heater_right": 2,
       "side_mirror_heaters": false,
-      "smart_preconditioning": false,
       "steering_wheel_heater": false,
       "timestamp": 1543186971731,
       "wiper_blade_heater": false
@@ -107,6 +107,7 @@ A rollup of all the `data_request` endpoints plus vehicle configuration.
       "managed_charging_start_time": null,
       "managed_charging_user_canceled": false,
       "max_range_charge_counter": 0,
+      "minutes_to_full_charge": 0,
       "not_enough_power_to_heat": false,
       "scheduled_charging_pending": false,
       "scheduled_charging_start_time": null,
@@ -122,34 +123,51 @@ A rollup of all the `data_request` endpoints plus vehicle configuration.
       "gui_distance_units": "mi/hr",
       "gui_range_display": "Rated",
       "gui_temperature_units": "F",
+      "show_range_units": true,
       "timestamp": 1543186971728
     },
     "vehicle_state": {
-      "api_version": 6,
+      "api_version": 7,
       "autopark_state_v2": "standby",
       "autopark_style": "standard",
       "calendar_supported": true,
-      "car_version": "2018.42.2 19e7e44",
+      "car_version": "2019.40.2.1 38f55d9f9205",
       "center_display_state": 0,
       "df": 0,
       "dr": 0,
+      "fd_window": 0,
+      "fp_window": 0,
       "ft": 0,
+      "homelink_device_count": 0,
       "homelink_nearby": true,
       "is_user_present": false,
       "last_autopark_error": "no_error",
       "locked": true,
-      "media_state": { "remote_control_enabled": true },
+      "media_state": {
+        "remote_control_enabled": true
+      },
       "notifications_supported": true,
       "odometer": 33561.422505,
       "parsed_calendar_supported": true,
       "pf": 0,
       "pr": 0,
+      "rd_window": 0,
       "remote_start": false,
       "remote_start_enabled": true,
       "remote_start_supported": true,
+      "rp_window": 0,
       "rt": 0,
       "sentry_mode": true,
-      "software_update": { "expected_duration_sec": 2700, "status": "" },
+      "sentry_mode_available": true,
+      "smart_summon_available": true,
+      "software_update": {
+        "download_perc": 100,
+        "expected_duration_sec": 2700,
+        "install_perc": 10,
+        "scheduled_time_ms": 1575689678432,
+        "status": "scheduled",
+        "version": "2019.40.2.1"
+      },
       "speed_limit_mode": {
         "active": false,
         "current_limit_mph": 75.0,
@@ -157,6 +175,7 @@ A rollup of all the `data_request` endpoints plus vehicle configuration.
         "min_limit_mph": 50,
         "pin_code_set": false
       },
+      "summon_standby_mode_enabled": true,
       "sun_roof_percent_open": 0,
       "sun_roof_state": "unknown",
       "timestamp": 1538364666096,
@@ -188,6 +207,7 @@ A rollup of all the `data_request` endpoints plus vehicle configuration.
       "third_row_seats": "None",
       "timestamp": 1538364666096,
       "trim_badging": "p90d",
+      "use_range_badging": false,
       "wheel_type": "AeroTurbine19"
     }
   }

data/docs/vehicle/state/guisettings.md

@@ -14,6 +14,7 @@ Returns various information about the GUI settings of the car, such as unit form
     "gui_distance_units": "mi/hr",
     "gui_range_display": "Rated",
     "gui_temperature_units": "F",
+    "show_range_units": true,
     "timestamp": 1543187561462
   }
 }

data/docs/vehicle/state/vehiclestate.md

@@ -4,36 +4,75 @@
 
 Returns the vehicle's physical state, such as which doors are open.
 
+For the trunk (rt) and frunk (ft) fields, you should interpret a zero (0) value as closed and a non-zero value as open (partially or fully).
+
+Here are the currently known values for the `center_display_state` field:
+
+| State | Description     |
+| ----- | --------------- |
+| 0     | Off             |
+| 2     | Normal On       |
+| 3     | Charging Screen |
+| 7     | Sentry Mode     |
+| 8     | Dog Mode        |
+
+Here are the descriptions for the shorthand fields:
+
+| Field | Description     |
+| ----- | --------------- |
+| df    | driver front    |
+| dr    | driver rear     |
+| pf    | passenger front |
+| pr    | passenger rear  |
+| ft    | front trunk     |
+| rt    | rear trunk      |
+
 ### Response
 
 ```json
 {
   "response": {
-    "api_version": 6,
-    "autopark_state_v2": "ready",
-    "autopark_style": "standard",
+    "api_version": 7,
+    "autopark_state_v3": "standby",
+    "autopark_style": "dead_man",
     "calendar_supported": true,
-    "car_version": "2018.42.2 19e7e44",
+    "car_version": "2019.40.2.1 38f55d9f9205",
     "center_display_state": 0,
     "df": 0,
     "dr": 0,
+    "fd_window": 0,
+    "fp_window": 0,
     "ft": 0,
+    "homelink_device_count": 0,
     "homelink_nearby": true,
     "is_user_present": false,
     "last_autopark_error": "no_error",
     "locked": true,
-    "media_state": { "remote_control_enabled": true },
+    "media_state": {
+      "remote_control_enabled": true
+    },
     "notifications_supported": true,
     "odometer": 36051.517239,
     "parsed_calendar_supported": true,
     "pf": 0,
     "pr": 0,
+    "rd_window": 0,
     "remote_start": false,
     "remote_start_enabled": true,
     "remote_start_supported": true,
+    "rp_window": 0,
     "rt": 0,
     "sentry_mode": true,
-    "software_update": { "expected_duration_sec": 2700, "status": "" },
+    "sentry_mode_available": true,
+    "smart_summon_available": true,
+    "software_update": {
+      "download_perc": 100,
+      "expected_duration_sec": 2700,
+      "install_perc": 10,
+      "scheduled_time_ms": 1575689678432,
+      "status": "scheduled",
+      "version": "2019.40.2.1"
+    },
     "speed_limit_mode": {
       "active": false,
       "current_limit_mph": 50.0,
@@ -41,6 +80,7 @@ Returns the vehicle's physical state, such as which doors are open.
       "min_limit_mph": 50,
       "pin_code_set": false
     },
+    "summon_standby_mode_enabled": true,
     "sun_roof_percent_open": 0,
     "sun_roof_state": "unknown",
     "timestamp": 1543187581934,
@@ -50,12 +90,3 @@ Returns the vehicle's physical state, such as which doors are open.
   }
 }
 ```
-
-### Center Display States
-| State | Description     |
-|-------|-----------------|
-| 0     | Off             |
-| 2     | Normal On       |
-| 3     | Charging Screen |
-| 7     | Sentry Mode     |
-| 8     | Dog Mode        |

data/lib/tesla_api/client.rb

@@ -2,7 +2,7 @@ module TeslaApi
   class Client
     attr_reader :api, :email, :access_token, :access_token_expires_at, :refresh_token, :client_id, :client_secret
 
-    BASE_URI = 'https://owner-api.teslamotors.com/api/1'
+    BASE_URI = 'https://owner-api.teslamotors.com'
 
     def initialize(
         email: nil,
@@ -10,9 +10,13 @@ module TeslaApi
         access_token_expires_at: nil,
         refresh_token: nil,
         client_id: ENV['TESLA_CLIENT_ID'],
-        client_secret: ENV['TESLA_CLIENT_SECRET']
+        client_secret: ENV['TESLA_CLIENT_SECRET'],
+        retry_options: nil,
+        base_uri: nil,
+        client_options: {}
     )
       @email = email
+      @base_uri = base_uri || BASE_URI
 
       @client_id = client_id
       @client_secret = client_secret
@@ -22,19 +26,22 @@ module TeslaApi
       @refresh_token = refresh_token
 
       @api = Faraday.new(
-        BASE_URI,
-        headers: { 'User-Agent' => "github.com/timdorr/tesla-api v:#{VERSION}" }
+        @base_uri + '/api/1',
+        {
+          headers: { 'User-Agent' => "github.com/timdorr/tesla-api v:#{VERSION}" }
+        }.merge(client_options)
       ) do |conn|
         conn.request :json
         conn.response :json
         conn.response :raise_error
+        conn.request :retry, retry_options if retry_options # Must be registered after :raise_error
         conn.adapter Faraday.default_adapter
       end
     end
 
     def refresh_access_token
       response = api.post(
-        'https://owner-api.teslamotors.com/oauth/token',
+        @base_uri + '/oauth/token',
         {
           grant_type: 'refresh_token',
           client_id: client_id,
@@ -52,7 +59,7 @@ module TeslaApi
 
     def login!(password)
       response = api.post(
-        'https://owner-api.teslamotors.com/oauth/token',
+        @base_uri + '/oauth/token',
         {
           grant_type: 'password',
           client_id: client_id,

data/lib/tesla_api/vehicle.rb

@@ -94,7 +94,7 @@ module TeslaApi
     end
 
     def set_charge_limit(percent)
-      command('set_charge_limit', body: {percent: percent})['response']
+      command('set_charge_limit', body: {percent: percent.to_i})['response']
     end
 
     def charge_start

data/lib/tesla_api/version.rb

@@ -1,3 +1,3 @@
 module TeslaApi
-  VERSION = '3.0.4'
+  VERSION = '3.0.5'
 end

data/spec/cassettes/client-login_timeout.yml

@@ -0,0 +1,83 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://owner-api.teslamotors.com/oauth/token
+    body:
+      encoding: UTF-8
+      string: grant_type=password&client_id=<TESLA_CLIENT_ID>&client_secret=<TESLA_CLIENT_SECRET>&email=<TESLA_EMAIL>&password=<TESLA_PASS>
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 408
+      message: Request Timeout
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Mon, 15 Dec 2014 03:09:22 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Status:
+      - 408 Request Timeout
+    body:
+      encoding: UTF-8
+      string: '{}'
+    http_version:
+  recorded_at: Mon, 15 Dec 2014 03:09:22 GMT
+- request:
+    method: post
+    uri: https://owner-api.teslamotors.com/oauth/token
+    body:
+      encoding: UTF-8
+      string: grant_type=password&client_id=<TESLA_CLIENT_ID>&client_secret=<TESLA_CLIENT_SECRET>&email=<TESLA_EMAIL>&password=<TESLA_PASS>
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - nginx
+      Date:
+      - Mon, 15 Dec 2014 03:09:22 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Status:
+      - 200 OK
+      Cache-Control:
+      - no-store
+      Pragma:
+      - no-cache
+      X-Ua-Compatible:
+      - IE=Edge,chrome=1
+      X-Request-Id:
+      - 349d563d345a9694c610770b743d3006
+      X-Runtime:
+      - '0.416152'
+    body:
+      encoding: UTF-8
+      string: '{"access_token":"1cba4845a8653d4b731440e9911d84304a179bd16a9ecbc9b649f2d8e0f6947e","token_type":"bearer","expires_in":7776000,"refresh_token":"fea03b395fa4e72ebc399d9cda6163dcf438c248f744ebdd5bfcda571f5f317f","created_at":1475777133}'
+    http_version:
+  recorded_at: Mon, 15 Dec 2014 03:09:22 GMT
+recorded_with: VCR 2.9.3

data/spec/lib/tesla_api/client_spec.rb

@@ -73,4 +73,34 @@ RSpec.describe TeslaApi::Client do
       expect(tesla_api.vehicles).to include(TeslaApi::Vehicle)
     end
   end
+
+  describe 'retry options', vcr: { cassette_name: 'client-login_timeout' } do
+    subject(:tesla_api) { TeslaApi::Client.new(
+      access_token: ENV['TESLA_ACCESS_TOKEN'],
+      retry_options: retry_options
+    ) }
+
+    let(:retry_options) {{
+      max: 2,
+      methods: [:post],
+      retry_statuses: [408]
+    }}
+
+    context 'with retry' do
+      it 'obtains a Bearer token after retry' do
+        tesla_api.login!(ENV['TESLA_PASS'])
+        expect(tesla_api.access_token).to be
+      end
+    end
+
+    context 'without retry' do
+      let(:retry_options) { nil }
+
+      it 'raises an error' do
+        expect {
+          tesla_api.login!(ENV['TESLA_PASS'])
+        }.to raise_error(Faraday::ClientError)
+      end
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tesla_api
 version: !ruby/object:Gem::Version
-  version: 3.0.4
+  version: 3.0.5
 platform: ruby
 authors:
 - Tim Dorr
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-10-14 00:00:00.000000000 Z
+date: 2020-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async-websocket
@@ -198,6 +198,7 @@ files:
 - lib/tesla_api/vehicle.rb
 - lib/tesla_api/version.rb
 - spec/cassettes/client-login.yml
+- spec/cassettes/client-login_timeout.yml
 - spec/cassettes/client-refresh.yml
 - spec/cassettes/client-vehicles.yml
 - spec/cassettes/vehicle-activate_speed_limit.yml
@@ -263,7 +264,7 @@ homepage: https://github.com/timdorr/tesla-api
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -278,12 +279,13 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
 summary: A wrapper for the Tesla JSON API
 test_files:
 - spec/cassettes/client-login.yml
+- spec/cassettes/client-login_timeout.yml
 - spec/cassettes/client-refresh.yml
 - spec/cassettes/client-vehicles.yml
 - spec/cassettes/vehicle-activate_speed_limit.yml