API 接口文档

基础URL: https://jz.79tap.cn/Accountbook/bookkeeping_api.php

请求方式: 所有接口均通过 GET 请求。

返回格式: 支持 text 和 json 两种格式，通过 format 参数指定。默认为 text。

示例: ...&format=json

获取今日账单 GET

描述: 获取当日的收入、支出和盈亏总结。

参数: action=get_today

示例:

https://jz.79tap.cn/Accountbook/bookkeeping_api.php?action=get_today

获取总账单 GET

描述: 获取所有时间的总收入、总支出和总盈亏总结。

参数: action=get_total

示例:

https://jz.79tap.cn/Accountbook/bookkeeping_api.php?action=get_total

获取所有备注统计 GET

描述: 获取所有账单的详细统计信息。

参数: action=get_all_statistics

示例:

https://jz.79tap.cn/Accountbook/bookkeeping_api.php?action=get_all_statistics

按备注查询 GET

描述: 根据备注关键词搜索账单记录，支持分页。

参数:

• action=query_by_note
• note=[搜索关键词]
• page=[页码] (可选, 默认为 1)

示例URL:

https://jz.79tap.cn/Accountbook/bookkeeping_api.php?action=query_by_note&note=餐饮&page=1

调用方式示例

cURL (命令行):

curl "https://jz.79tap.cn/Accountbook/bookkeeping_api.php?action=query_by_note¬e=餐饮&format=json"

JavaScript (Fetch API):

fetch('https://jz.79tap.cn/Accountbook/bookkeeping_api.php?action=query_by_note¬e=餐饮&format=json')
  .then(response => response.json())
  .then(data => console.log(data));

Python (requests库):

import requests

params = {
    'action': 'query_by_note',
    'note': '餐饮',
    'page': 1,
    'format': 'json'
}
response = requests.get('https://jz.79tap.cn/Accountbook/bookkeeping_api.php', params=params)
print(response.json())

添加新账单 GET

描述: 添加一笔新的收入或支出记录。

参数:

• action=add_transaction
• type=[类型] (income 或 expense)
• amount=[金额] (数字)
• note=[备注] (字符串)

示例URL:

https://jz.79tap.cn/Accountbook/bookkeeping_api.php?action=add_transaction&type=expense&amount=25.5¬e=午餐

调用方式示例

cURL (命令行):

curl "https://jz.79tap.cn/Accountbook/bookkeeping_api.php?action=add_transaction&type=expense&amount=25.5¬e=午餐&format=json"

JavaScript (Fetch API):

const params = new URLSearchParams({
    action: 'add_transaction',
    type: 'expense',
    amount: 25.5,
    note: '午餐',
    format: 'json'
});
fetch(`https://jz.79tap.cn/Accountbook/bookkeeping_api.php?${params}`)
  .then(response => response.json())
  .then(data => console.log(data));

Python (requests库):

import requests

payload = {
    'action': 'add_transaction',
    'type': 'expense',
    'amount': 25.5,
    'note': '午餐',
    'format': 'json'
}
response = requests.get('https://jz.79tap.cn/Accountbook/bookkeeping_api.php', params=payload)
print(response.json())

删除账单 GET

描述: 根据ID删除指定的账单记录。

参数:

• action=delete_transaction
• id=[账单ID] (数字)

示例:

https://jz.79tap.cn/Accountbook/bookkeeping_api.php?action=delete_transaction&id=101