点击展开字段说明
total int
符合条件的账单记录总数。
---
page int
当前页码。
---
pageSize int
每页条数。
---
list array
账单记录列表，每个「账期 × 机器人」一条。元素结构：
- `period`：账期，月粒度为 `YYYY-MM`，日粒度为 `YYYY-MM-DD`
- `billStatus`：出账状态，`SETTLED` / `UNSETTLED`
- `spaceId` / `spaceName`：机器人所属空间的 ID 与名称
- `robotId` / `robotName`：机器人 ID 与名称
- `usage`：用量列表，元素含 `code`、`name`、`value`、`unit`
- `feeItems`：计费项列表，元素含 `itemCode`、`itemName`、`amount`、`points`；机器人维度固定返回 `LINE`（线路）、`ROBOT`（机器人）、`DEBUG`（调试）三项
- `totalAmount`：合计金额（元，字符串，三位小数）
- `totalPoints`：合计积分（个）
完整字段说明见[账单记录的公共结构](https://avavox.com/docs/developer/bill/#账单记录的公共结构)。
## 请求示例
查询 2026 年 3 月至 8 月全部机器人的月度账单：
```shell
curl -X POST --location 'https://dashboard.avavox.com/open/api/v1/bills/robots/query' \
--header 'Authorization: Bearer $Key' \
--header 'Content-Type: application/json' \
--data '{
"granularity": "month",
"start": "2026-03",
"end": "2026-08"
}'
```
查询「保单续约专员」2026 年 8 月的每日账单（等价于控制台的「查看详情」）：
```shell
curl -X POST --location 'https://dashboard.avavox.com/open/api/v1/bills/robots/query' \
--header 'Authorization: Bearer $Key' \
--header 'Content-Type: application/json' \
--data '{
"granularity": "day",
"start": "2026-08-01",
"end": "2026-08-31",
"robotIds": ["rb_1001"]
}'
```
## 响应示例
```json
{
"code": 200,
"message": "操作成功",
"success": true,
"data": {
"total": 1,
"page": 1,
"pageSize": 20,
"list": [
{
"period": "2026-08",
"billStatus": "UNSETTLED",
"spaceId": "sp_001",
"spaceName": "花花",
"robotId": "rb_1001",
"robotName": "保单续约专员",
"usage": [
{ "code": "LINE_CALLS", "name": "线路用量", "value": 10, "unit": "个" },
{ "code": "ROBOT_CALLS", "name": "机器人用量", "value": 15, "unit": "个" }
],
"feeItems": [
{ "itemCode": "LINE", "itemName": "线路", "amount": "0.000", "points": 1000 },
{ "itemCode": "ROBOT", "itemName": "机器人", "amount": "0.000", "points": 420 },
{ "itemCode": "DEBUG", "itemName": "调试", "amount": "0.000", "points": 50 }
],
"totalAmount": "0.000",
"totalPoints": 1470
}
]
}
}
```