⚙️ Settings
⚠️ No email bound. Password recovery unavailable.
✅ Bound:
关于
🔑 API 访问密钥
生成密钥后可在终端用 curl 直接记账。密钥仅在生成时显示一次,请妥善保管。
⚠️ 请立即复制并保存密钥,此页面关闭后将无法再次查看。
创建于:
📋 使用示例
# 记一笔支出
curl -X POST https://lycheeledger.cn/api/v1/ledger/sync/upload \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"device_id":"cli","records":[{"client_id":1,"date":"2026-07-16","category":"餐饮","amount":-25.5,"note":"午餐","modified_ts":"2026-07-16T10:00:00Z"}]}'
# 获取所有记录
curl https://lycheeledger.cn/api/v1/ledger/sync/all \
-H "X-API-Key: YOUR_KEY"
# 删除记录
curl -X POST https://lycheeledger.cn/api/v1/ledger/sync/batch-delete \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"device_id":"cli","client_ids":[1]}'
✅ 创建于:
📖 如何调用
设置 API Key 后,可在终端用 curl 或脚本调用记账 API。三端通用:
① 设置环境变量
# 添加到 ~/.bashrc 或 ~/.zshrc export LEDGER_KEY="你的API密钥" export LEDGER_HOST="https://lycheeledger.cn"
② 记一笔支出
curl -s -X POST "$LEDGER_HOST/api/v1/ledger/sync/upload" \
-H "X-API-Key: $LEDGER_KEY" \
-H "Content-Type: application/json" \
-d "{\"device_id\":\"cli\",\"records\":[{\"client_id\":$(date +%s),\"date\":\"$(date +%Y-%m-%d)\",\"category\":\"餐饮\",\"amount\":-35,\"note\":\"外卖\",\"modified_ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}]}"
③ 记一笔收入
curl -s -X POST "$LEDGER_HOST/api/v1/ledger/sync/upload" \
-H "X-API-Key: $LEDGER_KEY" \
-H "Content-Type: application/json" \
-d "{\"device_id\":\"cli\",\"records\":[{\"client_id\":$(date +%s),\"date\":\"$(date +%Y-%m-%d)\",\"category\":\"工资\",\"amount\":8000,\"note\":\"本月\",\"modified_ts\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}]}"
④ 查看所有记录
curl -s "$LEDGER_HOST/api/v1/ledger/sync/all" -H "X-API-Key: $LEDGER_KEY" | python3 -m json.tool
⑤ 删除记录
curl -s -X POST "$LEDGER_HOST/api/v1/ledger/sync/batch-delete" \
-H "X-API-Key: $LEDGER_KEY" \
-H "Content-Type: application/json" \
-d '{"device_id":"cli","client_ids":[ID1,ID2]}'
① 设置环境变量
:: 临时生效(当前 CMD 窗口) set LEDGER_KEY=你的API密钥 set LEDGER_HOST=https://lycheeledger.cn :: 永久生效:setx LEDGER_KEY "你的API密钥"(需重开 CMD) :: :: ⚠️ 每次记账前改 client_id 避免覆盖上一条:%RANDOM%%RANDOM% 生成 0~10亿随机数
② 记一笔支出
:: 每次执行前改 C_ID 值,或用 set /a C_ID=%RANDOM%%RANDOM% 自动生成
set C_ID=1
curl -s -X POST "%LEDGER_HOST%/api/v1/ledger/sync/upload" ^
-H "X-API-Key: %LEDGER_KEY%" ^
-H "Content-Type: application/json" ^
-d "{\"device_id\":\"cli\",\"records\":[{\"client_id\":%C_ID%,\"date\":\"2026-07-16\",\"category\":\"餐饮\",\"amount\":-35,\"note\":\"外卖\",\"modified_ts\":\"2026-07-16T12:00:00Z\"}]}"
③ 记一笔收入
set /a C_ID=%RANDOM%%RANDOM%
curl -s -X POST "%LEDGER_HOST%/api/v1/ledger/sync/upload" ^
-H "X-API-Key: %LEDGER_KEY%" ^
-H "Content-Type: application/json" ^
-d "{\"device_id\":\"cli\",\"records\":[{\"client_id\":%C_ID%,\"date\":\"2026-07-16\",\"category\":\"工资\",\"amount\":8000,\"note\":\"本月\",\"modified_ts\":\"2026-07-16T12:00:00Z\"}]}"
④ 查看所有记录
curl -s "%LEDGER_HOST%/api/v1/ledger/sync/all" -H "X-API-Key: %LEDGER_KEY%"
⑤ 删除记录
:: 用查到的 client_id 替换 1,2
curl -s -X POST "%LEDGER_HOST%/api/v1/ledger/sync/batch-delete" ^
-H "X-API-Key: %LEDGER_KEY%" ^
-H "Content-Type: application/json" ^
-d "{\"device_id\":\"cli\",\"client_ids\":[1,2]}"
① 设置环境变量
# 当前会话
$env:LEDGER_KEY="你的API密钥"
$env:LEDGER_HOST="https://lycheeledger.cn"
# 永久生效:[Environment]::SetEnvironmentVariable("LEDGER_KEY","你的密钥","User")
② 记一笔支出
$body = @{
device_id="cli"
records=@(@{
client_id=(Get-Date -UFormat %s)
date=(Get-Date -Format "yyyy-MM-dd")
category="餐饮"
amount=-35
note="外卖"
modified_ts=(Get-Date -Format "yyyy-MM-ddTHH:mm:ssZ")
})
} | ConvertTo-Json -Compress
Invoke-RestMethod -Uri "$env:LEDGER_HOST/api/v1/ledger/sync/upload" `
-Method Post `
-Headers @{"X-API-Key"=$env:LEDGER_KEY} `
-ContentType "application/json" `
-Body $body
③ 查看所有记录
Invoke-RestMethod -Uri "$env:LEDGER_HOST/api/v1/ledger/sync/all" `
-Headers @{"X-API-Key"=$env:LEDGER_KEY} | ConvertTo-Json -Depth 10
④ 删除记录
$body = '{"device_id":"cli","client_ids":[1,2]}'
Invoke-RestMethod -Uri "$env:LEDGER_HOST/api/v1/ledger/sync/batch-delete" `
-Method Post `
-Headers @{"X-API-Key"=$env:LEDGER_KEY} `
-ContentType "application/json" `
-Body $body
💡 API Key 仅限记账/查询/删除,无法改密码或访问 AI 功能。生成后只显示一次。
📋 amount 负数=支出,正数=收入;client_id 每次需不同,重复会覆盖上一条记录。
账户信息
用户 ID:
记录数:
⚠️ 安全提示:您的密码可能不符合最新安全要求
新规则要求密码必须包含字母、数字和特殊符号。建议您修改密码以提升账户安全性。