cdnca

开放接口

/v1/modules

1 个接口

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

方法路径摘要认证
GET/v1/modulesList the module, pack and theme feature codes the local entitlement lease grants登录会话

契约文件：api/openapi/v1/control.yaml

接口详情

GET /v1/modules

List the module, pack and theme feature codes the local entitlement lease grants

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

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

说明（契约原文）

Any authenticated session. Modules is empty unless the verified local lease is valid (grace included is not valid), matching the API entry gate (entitlement_feature_denied) and the publication gate. Front-end menu items with requiredModule are shown only when the code is listed.

响应

listGrantedModules 响应
状态码说明
200Granted module codes.

字段：status: string lease_serial: integer modules: array<string>

401认证失败或会话已失效。
500服务内部故障，请求未完成。

失败时怎么办

  • 401 检查凭据格式、是否过期或被轮换。
  • 500 结果未知：先按资源 ID 或列表回读确认，再决定是否用原 Idempotency-Key 重试。

↑ 回到列表