# Boleto API

## 列出 Boleto

```
GET /api/boletos
```

### 查询参数

| 参数 | 类型 | 描述 |
|------|------|------|
| `status` | string | 按状态筛选 |
| `page` | integer | 页码 |
| `per_page` | integer | 每页数量 |

## 创建 Boleto

```
POST /api/boletos
```

### 请求体

| 字段 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `beneficiario` | object | 是 | 收款人（Cedente）信息 |
| `pagador` | object | 是 | 付款人（Sacado）信息 |
| `valor` | integer | 是 | 金额（分） |
| `vencimento` | string | 是 | 到期日 (YYYY-MM-DD) |

## 获取 Boleto 详情

```
GET /api/boletos/:id
```

返回包含条形码和可输入行在内的完整 Boleto 信息。