#Tank Utility

Add Tank Utility propane tank monitors to Home Assistant.

#Setup

#Authentication

Authentication for the Tank Utility API is performed with the same email and password credentials used at https://app.tankutility.com.

#Devices

Each item in the list of devices is a 24 character string. These values can be found by clicking on the Usage Reports link at the bottom of the graph on the Tank Utility devices page.

The device item value is the last segment of the URL path, e.g., the URL https://app.tankutility.com/#/reports/000000000000000000000000 would indicate 000000000000000000000000 as a device value.

#Using TankUtility API to Obtain Device ID

1. Obtain your personal token:

   curl --user <my_username>:<my_password> https://data.tankutility.com/api/getToken

   The JSON response structure should resemble:

   {"token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJleHAiOjE0MzgyMjQwODE0NjIsInYiOjAsImQiOnsidWleejoic2ltcGxlbG9naW46MzM1In0sImlhdCI6wwDIyMzk5NX0.kbYzxRtbGB2ke3IBgQTVMNQprHOWJZFgQQnPK6Wyas4"}

2. Receive the list of devices you have in your account:

   curl https://data.tankutility.com/api/devices?token=<my_personal_token>

   The JSON response structure should resemble:

   {"devices":["54df6a066667531535371367","54ff69057492666782350667"]}

#Configuration

To enable the integration, add the following lines to your "configuration.yaml" file. :::tip 更改配置后需要重启 Home Assistant。 :::

# Example configuration.yaml entry
sensor:
  - platform: tank_utility
    email: YOUR_EMAIL_ADDRESS
    password: YOUR_PASSWORD
    devices:
      - "000000000000000000000000"

email:
  description: "Your [https://app.tankutility.com](https://app.tankutility.com) email address."
  required: true
  type: string
password:
  description: "Your [https://app.tankutility.com](https://app.tankutility.com) password."
  required: true
  type: string
devices:
  description: All devices to monitor.
  required: true
  type: map