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集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more], add the following lines to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file. 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

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