## 所需权限
<table> <thead> <tr> <td><p><b>所需权限</b></p></td> <td><p><b>资源</b></p></td> <td><p><b>Scope</b></p></td> <td><p><b>资源服务</b></p></td> </tr> </thead> <tbody> <tr> <td><p>限额与计量读取（读取）</p></td> <td><p>quota</p></td> <td><p>admin.v1.quota.read</p></td> <td><p>qwenwork-biz-service</p></td> </tr> </tbody> </table>

```
HELPCODEESCAPE-http
GET /api/openapi/v1/metering-policy
```

## 公共请求头
适用《通过 API 配置 QwenWork 管理后台》的"认证与请求头"章节：`Authorization` 必填，`X-Request-Id` 可选；当前接口所需 Scope 见本页。

`Idempotency-Key` 是否适用及必填性以本页请求参数为准，不能用追踪标识替代幂等键。

## 请求参数
无请求参数。

## 请求示例
将 \<BASE_URL\> 替换为企业部署的千问办公 API 服务地址，并填写实际参数。示例中的占位值不能直接用于请求。

```
HELPCODEESCAPE-curl
curl --request GET \
  --url '<BASE_URL>/api/openapi/v1/metering-policy' \
  --header 'Authorization: Bearer <API_KEY>'
```

## 响应状态表
<table> <thead> <tr> <td><p><b>HTTP 状态码</b></p></td> <td><p><b>触发条件</b></p></td> <td><p><b>响应结构引用</b></p></td> <td><p><b>客户端处理建议</b></p></td> </tr> </thead> <tbody> <tr> <td><p>200</p></td> <td><p>请求成功</p></td> <td><p>见本文"响应结果"</p></td> <td><p>读取响应结果。</p></td> </tr> <tr> <td><p>default</p></td> <td><p>未单独列出的认证、授权、校验或依赖错误</p></td> <td><p>见《通过 API 配置 QwenWork 管理后台》的"通用错误"结构</p></td> <td><p>按状态与 code 处理；写操作重试前核实结果及幂等要求。</p></td> </tr> </tbody> </table>

## 响应结果
Content-Type: application/json
<table> <thead> <tr> <td><p><b>名称</b></p></td> <td><p><b>类型</b></p></td> <td><p><b>必填</b></p></td> <td><p><b>说明</b></p></td> <td><p><b>示例</b></p></td> </tr> </thead> <tbody> <tr> <td><p>cycle_mode</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>限量周期模式 取值："subscription-cycle"</p></td> <td><p><code>"subscription-cycle"</code></p></td> </tr> <tr> <td><p>data_as_of</p></td> <td><p>string · date-time</p></td> <td><p>是</p></td> <td><p>数据更新时间</p></td> <td><p><code>"2026-08-27T10:00:00Z"</code></p></td> </tr> <tr> <td><p>data_status</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>数据状态 取值："fresh"、"stale"</p></td> <td><p><code>"fresh"</code></p></td> </tr> <tr> <td><p>next_reset_at</p></td> <td><p>string</p></td> <td><p>是</p></td> <td><p>合法 RFC 3339 日期时间；上游未提供下次重置时间时为 ""（空字符串），不是 null。 RFC 3339 时间或空字符串。 AnyOf: \[{"format":"date-time","type":"string"},{"enum":\[""\],"type":"string"}\]</p></td> <td><p><code>"2026-08-27T10:00:00Z"</code></p></td> </tr> <tr> <td><p>updated_at</p></td> <td><p>string · date-time</p></td> <td><p>是</p></td> <td><p>更新时间</p></td> <td><p><code>"2026-08-27T10:00:00Z"</code></p></td> </tr> </tbody> </table>

## 响应示例
```
HELPCODEESCAPE-json
{
  "cycle_mode": "subscription-cycle",
  "data_as_of": "2026-08-27T10:00:00Z",
  "data_status": "fresh",
  "next_reset_at": "2026-08-27T10:00:00Z",
  "updated_at": "2026-08-27T10:00:00Z"
}
```