pyGoEdge-UserPanel/reference/goedge 文档/ServerBillService.md

# ServerBillService
> 服务账单相关服务

---

## countAllServerBills
> 查询服务账单数量

- 角色：`admin`, `user`
- HTTP：`POST https://backend.dooki.cloud/ServerBillService/countAllServerBills`
- RPC：`rpc countAllServerBills(CountAllServerBillsRequest) returns (RPCCountResponse);`

**请求对象 (`CountAllServerBillsRequest`)**

```json
{
  "userId": "int64 // 用户ID",
  "month": "string"
}
```

**响应对象 (`RPCCountResponse`)**

```json
{
  "count": "int64 // 数量"
}
```

**调用示例**

```bash
curl -X POST "https://backend.dooki.cloud/ServerBillService/countAllServerBills" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'
```

---

## listServerBills
> 查询服务账单列表

- 角色：`admin`, `user`
- HTTP：`POST https://backend.dooki.cloud/ServerBillService/listServerBills`
- RPC：`rpc listServerBills(ListServerBillsRequest) returns (ListServerBillsResponse);`

**请求对象 (`ListServerBillsRequest`)**

```json
{
  "userId": "int64 // 用户ID",
  "month": "string",
  "offset": "int64 // 读取位置",
  "size": "int64 // 数量，通常不能小于0"
}
```

**响应对象 (`ListServerBillsResponse`)**

```json
{
  "serverBills": "[]ServerBill"
}
```

**调用示例**

```bash
curl -X POST "https://backend.dooki.cloud/ServerBillService/listServerBills" \
  -H "Content-Type: application/json" \
  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
  -d '{
    ...
  }'
```

---