方法路径摘要认证
GET/v1/package-traffic-coverage查询本人套餐每个周期由全局流量包覆盖的流量(最近周期在前)登录会话

契约文件:api/control-package-usage.openapi.yaml

接口详情

GET /v1/package-traffic-coverage

查询本人套餐每个周期由全局流量包覆盖的流量(最近周期在前)

operationId
listTenantPackageTrafficCoverage
认证
  • 登录会话:主控登录后的 Bearer 会话,由客户本人在自己的主控里使用;插件不能要求客户交出会话。
所需权限

契约没有单独标注权限码,权限要求见下方说明与 403 响应。

参数

listTenantPackageTrafficCoverage 参数
名称位置类型必填说明
subscription_idquerystring(uuid)是—
limitqueryinteger否返回的周期数,默认 12

响应

listTenantPackageTrafficCoverage 响应
状态码说明
200每个周期由流量包覆盖的流量(字节,十进制字符串)与扣量批次

字段:subscription_id: string(uuid) items: array<PackageTrafficCoverageCycle>

400稳定错误信封
401稳定错误信封
403稳定错误信封
404稳定错误信封
408稳定错误信封
503稳定错误信封

失败时怎么办

  • 400 按字段说明修正参数或请求体再发;不要原样重试。
  • 401 检查凭据格式、是否过期或被轮换。
  • 403 检查 Key 范围与所有者当前权限、当前租户作用域;不要换更高权限账号绕过。
  • 404 资源不存在或不属于当前租户。
  • 503 依赖暂不可用:稍后用原 Idempotency-Key 重试。

↑ 回到列表