cdnca

开放接口

/v1/recharge-identity-policy

2 个接口

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

方法路径摘要认证
GET/v1/recharge-identity-policyRead the current tenant recharge identity policy登录会话
PUT/v1/recharge-identity-policyCAS update the current tenant recharge identity policy登录会话

契约文件：api/openapi/v1/recharge-identity-policy.yaml

接口详情

GET /v1/recharge-identity-policy

Read the current tenant recharge identity policy

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

全部需要：identity_verification.review

响应

getTenantRechargeIdentityPolicy 响应
状态码说明
200Current policy or exact completed replay.

字段：tenant_scope_id: string(uuid) revision: integer(int64) require_real_name: boolean updated_at: string(date-time) | null(date-time) replayed: boolean

400Stable error without raw service messages.
401Stable error without raw service messages.
403Stable error without raw service messages.
405Stable error without raw service messages.
409Stable error without raw service messages.
503Stable error without raw service messages.

失败时怎么办

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

↑ 回到列表

PUT /v1/recharge-identity-policy

CAS update the current tenant recharge identity policy

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

全部需要：identity_verification.review

参数

updateTenantRechargeIdentityPolicy 参数
名称位置类型必填说明
If-Matchheaderstring是Strong quoted current revision; use "0" while no explicit policy exists.
Idempotency-Keyheaderstring是—
X-Request-IDheaderstring是—

请求体

application/json · 必填：是

updateTenantRechargeIdentityPolicy 请求体
名称类型必填说明
require_real_nameboolean是—

↑ 回到列表