API 使用入门

创建个人令牌

登录后，进入“其他 → 设置 → API令牌”。正式安装和演示站均可体验。
填写用途名称，选择只读或读写，以及30、90或365天有效期，默认90天。
复制仅显示一次的令牌，保存在调用程序的私有配置中，不放到公开网页或代码仓库。

认证

export ILITEBOOK_URL=https://books.example.com
export ILITEBOOK_TOKEN=替换为你生成的令牌
curl "$ILITEBOOK_URL/api/v1/ledgers" \
  -H "Authorization: Bearer $ILITEBOOK_TOKEN"

版本与账号权限

免费版允许查询、报表和附件下载，禁止创建、修改、删除及上传。商业版允许完整记账API，仍受令牌范围、账号状态及账本权限约束。

系统配置、用户管理、账本授权分配和商业授权管理不对外开放。Demo可体验完整记账API，但仍受用户和账本权限约束；令牌在当前两小时演示会话结束、重置或退出时失效。改密、重置密码、变更邮箱或撤销令牌后，需要重新授权调用程序。

数据格式

请求使用JSON，金额是字符串如 "12.34"，日期为YYYY-MM-DD，ID使用字符串。列表默认20条，page和page_size控制分页，最多100条。普通响应为 {"data": ...}，失败为 {"error":{"code":"..."}}。

重试和并发修改

创建流水或转账可发送Idempotency-Key。同一令牌、路径和键重复请求不会重复记账；更换内容必须换键。更新和删除已有记录在JSON中携带version，冲突返回409，应重新读取记录后确认修改。