Home Assistant 集成

Home Assistant 通过 SimpleFIN 读取您已连接到 BankSync 的银行。只需粘贴一个设置令牌:无需再次登录银行,也无需单独订阅 SimpleFIN。

Home Assistant · SimpleFIN06:00 更新

传感器

  • Chase Checking 余额Chase$6,158.00
  • Amex Gold 余额American Express-$1,284.16

连接

  • Chase 问题关闭,连接正常正常
  • American Express 问题关闭,连接正常正常
一个设置令牌,只需粘贴一次。此后 Home Assistant 将从 Chase 和 American Express 读取余额。

一个​令牌,只需​粘贴​一次

  1. 01

    创建​访问​权限

    Settings › Developers › SimpleFIN。选择 Home Assistant,也可以只选择部分账户。

    应用Home Assistant
    账户☑ Chase Checking
    账户☑ Amex Gold
    账户☐ Chase Savings
  2. 02

    复制​设置​令牌

    令牌只显示一次,如果从未使用,将在 7 天后过期。

    设置令牌

    aHR0cHM6Ly9hcGkuYmFua3N5bmMuaW8vc2ltcGxlZmluL2NsYWltL3N0XzRmOWMy…
    显示次数一次
    未使用7 天后过期
  3. 03

    粘贴到 Home Assistant

    应用会用它换取自己的凭据,此后自动同步。

    1设置 → 设备与服务
    2添加集成 → SimpleFIN
    3粘贴设置令牌

Home Assistant 读取的数据

账户
访问权限范围内的每个账户,包括名称、银行和币种。
余额
当前余额和可用余额,以及银行报告的时间。
错误
需要在 BankSync 中重新连接的银行会报告给应用,以便应用向您显示。
在任意访问权限上打开 Preview,即可查看应用收到的确切响应。

预算​应用​只是​其中​一站,而非全部

Home Assistant:要点一览

协议
SimpleFIN。BankSync 是服务器,应用是客户端。
适用于
Actual Budget、Securo、Sure、Home Assistant、Firefly III、beancount 导入工具以及您自己的脚本。
范围
所有账户,或仅限您选择的账户。之后可随时修改,无需重新关联。
控制
“Rotate”(轮换)会签发新令牌并停用旧凭据。“Revoke”(撤销)会永久终止访问。
访问方式
只读,在银行自己的授权页面上完成授权。BankSync 从不存储您的银行登录信息,也无法转移资金。
设置
约 2 分钟。 所有 BankSync 套餐均包含。
状态
现已可用。

常见​问题​解答

我需要订阅 SimpleFIN Bridge 吗?

不需要。BankSync 就是 SimpleFIN 服务器,所有 BankSync 套餐(包括 Free)都包含 SimpleFIN 访问。在应用要求输入 SimpleFIN 令牌的位置粘贴 BankSync 令牌即可。

如何将 Home Assistant 连接到 BankSync?

在 BankSync 中打开“Settings › Developers › SimpleFIN”并创建访问权限。复制设置令牌,然后在 Home Assistant 中:设置 → 设备与服务, 添加集成 → SimpleFIN, 粘贴设置令牌。

能否限制 Home Assistant 可以查看的账户?

可以。创建访问权限时选择账户,之后可随时修改列表,无需重新关联。应用会在下次同步时看到新列表。

设置令牌泄露了怎么办?

轮换(Rotate)该访问权限。轮换会签发新的设置令牌,并立即停用应用持有的凭据。“Revoke”(撤销)则会永久终止访问。未使用的令牌也会在 7 天后过期。

Home Assistant 多久更新一次余额?

Home Assistant 每四小时轮询一次。每个账户都会成为一个余额传感器;当某家银行需要在 BankSync 中重新连接时,该连接的问题传感器会开启。

在 Home Assistant 中查看您的银行

BankSync 与 Home Assistant 无关联,未获其认可,也不是其官方合作伙伴。Home Assistant 商标归其各自所有者所有。