可通过两种方式接入 AutoAccounting:
- 接收账单:提供 Url Scheme,接收识别后的账单推送。
- 主动同步:调用开放 API,拉取或推送账本、分类、资产等数据。
方式一:接收账单(Url Scheme)
在记账应用中提供 Url Scheme,处理来自 AutoAccounting 的请求。
请求类型
Tip
最低要求:至少实现记账请求处理,即可满足基本记账。
参数参考
参数名可自定义。传参方式参考已适配应用源码:
也可参考 钱迹自动化接口。
方式二:API 同步
主动推送或拉取数据时,直接调用本地 HTTP API:
| 接口 | 说明 |
|---|---|
| 同步账本 | POST /book/put |
| 同步分类 | POST /category/put |
| 同步资产 | POST /assets/put |
| 同步报销单 | POST /bill/book/put |
| 提取待同步账单 | POST /bill/sync/list |
| 获取设置 | POST /setting/get |
代码健壮性
Caution
AutoAccounting 可能传入异常值。必须做校验,避免脏数据与崩溃。
| 校验点 | 建议策略 |
|---|---|
| 账本存在性 | 默认账本回退 |
| 账单存在性 | 覆盖退款、报销场景 |
| 分类存在性 | 校验是否属于当前账本;缺失则创建或回退默认分类 |
| 金额有效性 | 必须为正数 |
| 资产存在性 | 自动创建或拒绝记账 |
实现选择
无需实现全部接口。仅实现记账接口即可满足基本需求。