# 查询配额策略列表

`GET` `/api/tokenBudget/listPolicies`

分页查询分配给当前应用的配额策略列表，支持按策略名称模糊过滤，按分配时间倒序返回。策略由租户管理员通过工单分配给应用，未分配给当前应用的策略不会出现在列表中。返回的 policyId 用于「绑定配额策略」接口，绑定前可先通过本接口确认策略的额度上限与重置规则。本接口仅支持通过API调用。

## 请求参数

### Query 参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| keyword | string | 否 | 策略名称模糊关键字（可选） |
| page | integer | 否 | 页码，从1开始 |
| pageSize | integer | 否 | 每页记录数，取值范围1~100 |

## 响应

### 200

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | PageResultTokenBudgetPolicyVO | 响应数据 |
|     items | array | 数据列表 |
|         policyId | integer | 策略ID，「绑定配额策略」接口的 policyId 即传此值 |
|         policyName | string | 策略名称 |
|         totalTokens | integer | 每个周期的主额度上限（Token 数） |
|         expireType | string | 有效期类型，可选值：PERMANENT（永久有效）、FIXED_DATE（到期失效） |
|         expireAt | string | 策略失效时间，仅 expireType 为 FIXED_DATE 时有值 |
|         resetType | string | 重置策略，可选值：NONE（不重置）、DAILY（每日）、WEEKLY（每周）、MONTHLY（每月） |
|         resetDay | integer | 重置日：resetType 为 WEEKLY 时取 1-7、MONTHLY 时取 1-31，其余为 0 |
|         remark | string | 备注 |
|         gmtCreate | string | 策略创建时间 |
|     total | integer | 总记录数 |
|     page | integer | 当前页码，从1开始 |
|     pageSize | integer | 每页大小 |
|     totalPages | integer | - |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 400

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |

### 500

| 参数名 | 类型 | 说明 |
|--------|------|------|
| httpStatusCode | integer | HTTP状态码 |
| message | string | 响应消息 |
| data | object | 响应数据 |
| success | boolean | 是否成功 |
| requestId | string | 上游请求ID，用于跨系统链路追踪排查问题 |
| errCode | string | 上游错误码，前端可据此做特殊UI处理 |