开放平台

平台统计。响应示例：

{
  "data": { "orgs": 5, "ledgers": 6, "entries": 51, "questions_answered": 7 }
}

团体搜索。参数：

响应（节选）——内部公开团体会返回 visibility:"internal"，其内容端点需门禁（见内部公开访问）：

{
  "data": [{
    "slug": "wutong", "name": "梧桐社区互助会",
    "org_type": "公益机构", "region": "江苏 · 南京 · 梧桐街道",
    "visibility": "public", "verified": true,
    "ledger_count": 2, "entry_count": 16, "url": "/org/wutong"
  }],
  "meta": { "q": "互助", "type": null }
}

团体详情：汇总收支、账本列表（每个账本带 entries_url）。响应（节选）：

{
  "data": {
    "slug": "wutong", "name": "梧桐社区互助会", "visibility": "public",
    "totals": { "income": "47032.50", "expense": "16424.50", "balance": "30608.00" },
    "ledgers": [{
      "id": 1, "name": "社区老人关爱基金", "status": "open",
      "goal": "50000.00", "income": "47032.50", "expense": "16424.50",
      "entries_url": "/api/v1/orgs/wutong/ledgers/1/entries"
    }]
  }
}

账本流水分页查询——本平台最常用的端点。参数：

响应（节选）——每笔带 balance_after 逐笔结余，meta.summary 为全账本汇总：

{
  "data": [{
    "id": 15, "seq": 15, "date": "2026-09-10",
    "kind": "expense", "kind_label": "支出",
    "title": "中秋慰问礼包（米 10 斤、油 5L、月饼）52 份",
    "category": "物资采购", "amount": "7488.00",
    "counterparty": "惠民超市（梧桐店）", "handler": "志愿者 周芸",
    "status": "normal", "balance_after": "3202.00",
    "url": "/org/wutong/ledger/1#entry-15"
  }],
  "meta": {
    "total": 16, "page": 1, "per_page": 50,
    "summary": { "income": "47032.50", "expense": "16424.50", "balance": "30608.00" }
  }
}

单笔详情：凭证图片 URL、公开问答、修改/作废留痕——完整信任链数据。响应（节选）：

{
  "data": {
    "id": 15, "title": "中秋慰问礼包……", "amount": "7488.00",
    "attachments": [{ "url": "/uploads/seed-fapiao-zhongqiu.svg", "name": "惠民超市-中秋礼包发票.svg" }],
    "questions": [{ "asker": "陈阿姨（社区居民）", "question": "礼包里的月饼是什么牌子、单价多少？",
                    "answer": "是本地老字号的散装广式月饼，18 元/盒……" }],
    "revisions": [{ "action": "edit", "reason": "与超市按实际结算价开票，金额由 7,696.00 更正为 7,488.00" }]
  }
}

列出自己团体的账本（获取 ledger_id 用）。

API 记一笔——保存即公开，与手工记录同规则（连续编号、可修正不可删除）。参数：

成功响应 201（节选）；字段错误返回 400 并逐字段说明：

# 请求
curl -X POST /api/v1/entries \
  -H "Authorization: Bearer cbk_你的密钥" -H "Content-Type: application/json" \
  -d '{
    "ledger_id": 1, "kind": "income", "date": "2026-09-29",
    "title": "线上捐赠（小程序渠道，23 人）",
    "amount": "1268.50", "category": "个人捐赠",
    "counterparty": "23 位爱心网友", "mask_counterparty": true
  }'

# 201 成功
{ "data": { "id": 17, "seq": 17, "amount": "1268.50", "url": "/org/wutong/ledger/1#entry-17" },
  "message": "已记入「社区老人关爱基金」第 17 笔，保存即公开" }

# 400 字段错误
{ "error": "bad_request", "message": "参数校验未通过",
  "fields": { "title": "事项摘要需 4~100 字", "category": "分类不在收入分类表内" } }

分类表——收入：成员缴费/AA、个人捐赠、企业/单位捐赠、公共收益/租金、活动/义卖收入、基金会/政府资助、利息及其他；支出：物资采购、餐饮聚餐、活动执行、场地租赁、交通差旅、补助/慰问金、对外捐赠、宣传印刷、押金/退款、运营杂费、其他。