cdnca

开放接口

/v1/escalate

6 个接口

← 全部分组 · 第一次调用？先看教程：认证、权限、请求与响应、常见失败

方法路径摘要认证
GET/v1/escalate/granteesActive resellers the session scope may grant line groups to登录会话
GET/v1/escalate/line-groupsList the line groups the session scope may use for B/C (own and granted) with their tier登录会话
GET/v1/escalate/line-groups/grantsThe grants the session scope made, newest first, revoked ones included登录会话
POST/v1/escalate/line-groups/grantsGrant a platform line group to an active reseller登录会话
DELETE/v1/escalate/line-groups/grants/{grant_id}Revoke a grant; the reseller's packages using the line group are withdrawn and their B/C cleared登录会话
PUT/v1/escalate/line-groups/{line_group_id}/tierMark one of the session scope's own line groups 普通 / 高防 / 无限防登录会话

契约文件：api/control-escalate.openapi.yaml

接口详情

GET /v1/escalate/grantees

Active resellers the session scope may grant line groups to

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

全部需要：node_scheduling.manage

说明（契约原文）

The platform gets the active resellers (an active tenant with an active reseller profile); a tenant (reseller) gets an empty list, as 1.0.35 has one level. Replaces GET /v1/admin/tenant-scopes in the grant dialog.

参数

listEscalateGrantees 参数
名称位置类型必填说明
searchquerystring否Short tenant ID, or a case-insensitive substring of the tenant name or scope UUID.

响应

listEscalateGrantees 响应
状态码说明
200At most 200 resellers ordered by name.

字段：items: array<Grantee>

400Error.
401Error.
403Error.
503Error.

失败时怎么办

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

↑ 回到列表

GET /v1/escalate/line-groups

List the line groups the session scope may use for B/C (own and granted) with their tier

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

全部需要：node_scheduling.read

响应

listEscalateLineGroups 响应
状态码说明
200Usable line groups.

字段：items: array<UsableLineGroup>

400Error.
401Error.
403Error.
503Error.

失败时怎么办

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

↑ 回到列表

GET /v1/escalate/line-groups/grants

The grants the session scope made, newest first, revoked ones included

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

全部需要：node_scheduling.manage

说明（契约原文）

NODE-N05. Cursor paged by (created_at, id) descending; next_cursor is empty on the last page. Only the session scope's own grants (grantor_scope_id); a reseller gets none, as 1.0.35 has one level. Revoked grants carry revoked_at so the history stays visible; only live ones can be revoked.

参数

listEscalateLineGroupGrants 参数
名称位置类型必填说明
cursorquerystring否—
limitqueryinteger否—

响应

listEscalateLineGroupGrants 响应
状态码说明
200A page of grants.

字段：items: array<GrantRecord> next_cursor: string

400Error.
401Error.
403Error.
503Error.

失败时怎么办

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

↑ 回到列表

POST /v1/escalate/line-groups/grants

Grant a platform line group to an active reseller

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

全部需要：node_scheduling.manage

需要开通的功能：module.escalate

说明（契约原文）

Only the platform grants, only its own line groups, and only to an active reseller (GET /v1/escalate/grantees). 1.0.35 has one reseller level, so may_regrant must be false (422 escalate_regrant_unsupported); a grantee that is not an active reseller is 422 escalate_grantee_not_reseller; a tenant caller or a line group the platform does not own is 403 escalate_grant_denied.

请求体

application/json · 必填：是

grantEscalateLineGroup 请求体
名称类型必填说明
owner_scope_idstring(uuid)是—
line_group_idstring(uuid)是—
grantee_scope_idstring(uuid)是—
may_regrantboolean是Must be false in 1.0.35.

响应

grantEscalateLineGroup 响应
状态码说明
201The grant.

字段：id: string(uuid) owner_scope_id: string(uuid) line_group_id: string(uuid) grantor_scope_id: string(uuid) grantee_scope_id: string(uuid) may_regrant: boolean created_at: string(date-time)

400Error.
401Error.
403Error.
404Error.
409Error.
422Error.
503Error.

失败时怎么办

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

↑ 回到列表

DELETE /v1/escalate/line-groups/grants/{grant_id}

Revoke a grant; the reseller's packages using the line group are withdrawn and their B/C cleared

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

全部需要：node_scheduling.manage

需要开通的功能：module.escalate

说明（契约原文）

In one transaction: the grant (and anything passed on) is revoked, every published package of the reseller that uses the line group is withdrawn, and B/C pointing at it are cleared (audited in the reseller's scope as package.escalate_policy.grant_revoked). Sold subscriptions keep their snapshot until they expire.

参数

revokeEscalateLineGroupGrant 参数
名称位置类型必填说明
grant_idpathstring(uuid)是—

响应

revokeEscalateLineGroupGrant 响应
状态码说明
200What the revocation did.

字段：revoked: integer withdrawn_products: array<string(uuid)> cleared_policies: array<string(uuid)>

400Error.
401Error.
403Error.
404Error.
503Error.

失败时怎么办

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

↑ 回到列表

PUT /v1/escalate/line-groups/{line_group_id}/tier

Mark one of the session scope's own line groups 普通 / 高防 / 无限防

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

全部需要：node_scheduling.manage

需要开通的功能：module.escalate

参数

putEscalateLineGroupTier 参数
名称位置类型必填说明
line_group_idpathstring(uuid)是—

请求体

application/json · 必填：是

putEscalateLineGroupTier 请求体
名称类型必填说明
tierstring: normal / high_defense / unlimited是—

响应

putEscalateLineGroupTier 响应
状态码说明
200The tier written.

字段：line_group_id: string(uuid) tier: string: normal / high_defense / unlimited

400Error.
401Error.
403Error.
404Error.
503Error.

失败时怎么办

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

↑ 回到列表