# 查询当前组织的当日额度

查询当前组织接口调用的当日额度（按北京时间自然日，API 与 MCP 连接共用）：建码、表单和模板、上传素材各自的 used、reserved、remaining，以及频率上限。未启用限额时返回 enabled=false；查询本身不扣业务日额度。

## 请求

```text
POST https://open.cli.im/api/v2/rpc/usage/get
```

| 项目 | 要求 |
|---|---|
| 最低权限 | 只读，见[权限档位](https://cli.im/open-api/openapi/v2/auth.md#org-policy) |
| 需要的 scope | 不需要，有效凭证即可 |
| 组织 Key | 可以调用 |

## 请求参数

没有参数，请求体传 `{}`。

## 请求示例

示例里的 ID、幂等键等换成实际值。

```bash
curl -sS -X POST 'https://open.cli.im/api/v2/rpc/usage/get' \
  -H "Authorization: Bearer ${CAOLIAO_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{}'
```

## 响应

成功时 HTTP 状态码为 200，顶层 `code` 为 `0`，结果在 `data` 里。失败时的返回见[错误码与调用额度](https://cli.im/open-api/openapi/v2/error-codes.md)和[业务错误码](https://cli.im/open-api/openapi/v2/error-catalog.md)。

| 字段 | 类型 | 一定返回 | 说明 |
|---|---|---|---|
| `data.enabled` | boolean | 是 | 是否启用了额度限制。为 false 时不返回其余字段 |
| `data.date` | string | 否 | 额度所属日期（北京时间），如 2026-11-18 |
| `data.reset_at` | integer | 否 | 额度重置时间（Unix 秒），即下一个北京时间零点 |
| `data.plan` | string | 否 | 当前组织适用的额度方案 |
| `data.protected` | any | 否 | 是否处于保护状态 |
| `data.policy_revision` | any | 否 | 额度策略的版本 |
| `data.enforced` | boolean | 否 | 超出额度时是否拒绝请求；false 表示只统计不拦截 |
| `data.daily` | object | 否 | 当日额度 |
| `data.daily.qrcode_daily` | object | 是 | 建码 |
| `data.daily.qrcode_daily.limit` | integer | 是 | 上限 |
| `data.daily.qrcode_daily.used` | integer | 是 | 已用 |
| `data.daily.qrcode_daily.reserved` | integer | 是 | 进行中的操作暂占 |
| `data.daily.qrcode_daily.remaining` | integer | 是 | 剩余 |
| `data.daily.form_template_daily` | object | 是 | 新建表单和模板 |
| `data.daily.form_template_daily.limit` | integer | 是 | 上限 |
| `data.daily.form_template_daily.used` | integer | 是 | 已用 |
| `data.daily.form_template_daily.reserved` | integer | 是 | 进行中的操作暂占 |
| `data.daily.form_template_daily.remaining` | integer | 是 | 剩余 |
| `data.daily.upload_daily` | object | 是 | 上传素材 |
| `data.daily.upload_daily.limit` | integer | 是 | 上限 |
| `data.daily.upload_daily.used` | integer | 是 | 已用 |
| `data.daily.upload_daily.reserved` | integer | 是 | 进行中的操作暂占 |
| `data.daily.upload_daily.remaining` | integer | 是 | 剩余 |
| `data.daily.read_daily` | object | 是 | 读取。超出后降低频率，不会拒绝 |
| `data.daily.read_daily.limit` | integer | 是 | 上限 |
| `data.daily.read_daily.used` | integer | 是 | 已用 |
| `data.daily.read_daily.degraded` | boolean | 是 | 是否已超出并降低频率 |
| `data.rates_per_second` | object | 否 | 每秒请求数上限 |
| `data.rates_per_second.read_rate` | number | 是 | 读接口 |
| `data.rates_per_second.write_rate` | number | 是 | 写接口 |
| `data.rates_per_second.control_rate` | number | 是 | 凭证和额度查询 |
| `data.rates_per_second.degraded_read_rate` | number | 是 | 读取超出当日额度后的读接口 |
| `data.batch_max` | integer | 否 | 单次批量建码的最大条数 |

### 响应示例

```json
{
  "code": 0,
  "message": "ok",
  "data": {
    "enabled": true,
    "date": "2026-11-18",
    "reset_at": 1795017600,
    "plan": "standard",
    "protected": false,
    "policy_revision": 3,
    "enforced": true,
    "daily": {
      "qrcode_daily": {
        "limit": 1000,
        "used": 12,
        "reserved": 2,
        "remaining": 986
      },
      "form_template_daily": {
        "limit": 100,
        "used": 1,
        "reserved": 0,
        "remaining": 99
      },
      "upload_daily": {
        "limit": 500,
        "used": 3,
        "reserved": 0,
        "remaining": 497
      },
      "read_daily": {
        "limit": 10000,
        "used": 240,
        "degraded": false
      }
    },
    "rates_per_second": {
      "read_rate": 10,
      "write_rate": 2,
      "control_rate": 2,
      "degraded_read_rate": 1
    },
    "batch_max": 100
  }
}
```

---

本页由 [openapi.json](https://cli.im/open-api/openapi/v2/overview.md#%E6%8E%A5%E5%8F%A3%E8%A7%84%E8%8C%83-openapi-json) 生成。全部接口见[接口清单](https://cli.im/open-api/openapi/v2/api-index.md)。
