Bills 账单管理 模块 API 文档
基础信息
- Base URL:
/api/admin - 认证方式: JWT Bearer Token
数据库表
bills— 账单表bill_members— 账单成员表users— 用户表
接口列表
1. 获取账单列表
GET /api/admin/bills
Query 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| start_date | string | 选填 | 创建时间起始 |
| end_date | string | 选填 | 创建时间截止 |
| owner_id | string | 选填 | 账单所有者ID |
| shared_with | string | 选填 | 共享成员ID |
响应:
[{
"id": "string",
"name": "string",
"owner_id": "string",
"owner_nickname": "string",
"member_count": 3,
"tx_count": 45,
"created_at": "ISO8601"
}]
2. 获取账单详情
GET /api/admin/bills/:billId
说明: 获取账单详细信息及成员列表
响应:
{
"id": "string",
"name": "string",
"owner_id": "string",
"owner_nickname": "string",
"created_at": "ISO8601",
"members": [{
"user_id": "string",
"role": "owner|member",
"nickname": "string"
}]
}