查询个人&企业账单列表

接口路径

GET /api/open/bills

配额计算说明

total_quota 为内部额度单位，换算成金额（人民币）的方式：

金额(¥) = total_quota ÷ quota_per_unit × usd_exchange_rate

其中：

• total_quota：来自本接口返回的 data.bills[].total_quota
• quota_per_unit、usd_exchange_rate、quota_display_type：来自 查询换算参数 接口（GET /api/open/status）

若 quota_display_type = USD（美元），则去掉 × usd_exchange_rate。

说明：total_fee 已是人民币金额（元），无需再换算。

请求参数

字段	类型	必传	说明	限制条件
year	int	否	账单对应年份	示例：2026
month	int	否	账单对应月份	示例：4（表示4月）
page	int	否	页码	默认值：1
limit	int	否	每页条数	默认值：10，最大值：100

请求示例

GET 'https://neolink.com/backend/api/open/bills?year=2026&month=4&page=1&limit=10'

返回信息

字段	类型	是否必传	说明	备注
success	bool	是	请求是否成功	固定值
message	string	是	错误提示信息（成功时为空）	固定值
data	BillsPageData	是	账单分页数据	详见下表

BillsPageData 对象

字段	类型	是否必传	说明	备注
bills	[]Bill	是	账单数组	本页账单列表；详见下表
total	int	是	总账单数	满足条件的账单总数
page	int	是	当前页码	从 1 开始
page_size	int	是	每页条数	返回的实际账单数

Bill 对象

字段	类型	是否必传	说明	备注
id	int	是	账单 ID	数据库唯一标识
bill_no	string	是	账单号	格式: BIL-YYYY-MM-NNN
bill_type	int	是	账单类型	0=标准账单；1=预付款账单等
target_id	int	是	目标 ID	用户或企业 ID
target_name	string	是	目标名称	用户昵称或企业名称
year	int	是	账单年份	如 2026
month	int	是	账单月份	1-12
status	int	是	账单状态	0=未结算；1=已结算
total_quota	int64	是	总配额	本月消耗的总配额；换算见上文「配额计算说明」
total_fee	float	是	总费用	本月应收费用（单位：元）

返回示例

成功响应
{
  "success": true,
  "message": "",
  "data": {
    "bills": [
      {
        "id": 12345,
        "bill_no": "BIL-2026-04-001",
        "bill_type": 0,
        "target_id": 100,
        "target_name": "用户昵称",
        "year": 2026,
        "month": 4,
        "status": 0,
        "total_quota": 50000,
        "total_fee": 250.00
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 10
  }
}