cdnca

API reference

/v1/package-traffic-coverage

1 operations

← All groups · First call? Read the tutorial: auth, permissions, requests and responses, common failures

MethodPathSummaryAuth
GET/v1/package-traffic-coverage查询本人套餐每个周期由全局流量包覆盖的流量（最近周期在前）Session

Contract file：api/control-package-usage.openapi.yaml

Operation details

GET /v1/package-traffic-coverage

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

operationId
listTenantPackageTrafficCoverage
Auth
  • Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
Required permissions

The contract has no separate permission annotation; see the description below and the 403 response.

Parameters

listTenantPackageTrafficCoverage Parameters
NameInTypeRequiredDescription
subscription_idquerystring(uuid)Yes—
limitqueryintegerNo返回的周期数，默认 12

Responses

listTenantPackageTrafficCoverage Responses
StatusDescription
200每个周期由流量包覆盖的流量（字节，十进制字符串）与扣量批次

Fields：subscription_id: string(uuid) items: array<PackageTrafficCoverageCycle>

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

What to do on failure

  • 400 Fix the parameters or body per the field list; do not retry unchanged.
  • 401 Check the credential format and whether it expired or was rotated.
  • 403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.
  • 404 The resource does not exist or belongs to another tenant.
  • 503 A dependency is unavailable: retry later with the original Idempotency-Key.

↑ Back to list