Home Assistant 集成
Home Assistant 通过 SimpleFIN 读取您已连接到 BankSync 的银行。只需粘贴一个设置令牌:无需再次登录银行,也无需单独订阅 SimpleFIN。
传感器
- Chase Checking 余额Chase$6,158.00
- Amex Gold 余额American Express-$1,284.16
连接
- Chase 问题关闭,连接正常正常
- American Express 问题关闭,连接正常正常
一个令牌,只需粘贴一次
- 01
创建访问权限
Settings › Developers › SimpleFIN。选择 Home Assistant,也可以只选择部分账户。
应用Home Assistant账户☑ Chase Checking账户☑ Amex Gold账户☐ Chase Savings - 02
复制设置令牌
令牌只显示一次,如果从未使用,将在 7 天后过期。
设置令牌
aHR0cHM6Ly9hcGkuYmFua3N5bmMuaW8vc2ltcGxlZmluL2NsYWltL3N0XzRmOWMy…显示次数一次未使用7 天后过期 - 03
粘贴到 Home Assistant
应用会用它换取自己的凭据,此后自动同步。
1设置 → 设备与服务2添加集成 → SimpleFIN3粘贴设置令牌
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 中重新连接时,该连接的问题传感器会开启。
BankSync 与 Home Assistant 无关联,未获其认可,也不是其官方合作伙伴。Home Assistant 商标归其各自所有者所有。