方法路径摘要认证
GET/v1/public/sdk-shield/apps/{app_id}/node-list公开节点列表(签名信封,无需登录)无需认证

契约文件:api/control-sdk-shield.openapi.yaml

接口详情

GET /v1/public/sdk-shield/apps/{app_id}/node-list

公开节点列表(签名信封,无需登录)

operationId
getSDKShieldPublicNodeList
认证
  • 无需认证。
所需权限

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

说明(契约原文)

An unknown, disabled or deleted app, an app without serving nodes, and module.sdkshield not granted or stopped on this controller all answer 404 (never why). Cache-Control: public, max-age=60; rate limited per source IP (429). Tenants may mirror the envelope to any HTTPS address: SDKs verify it themselves.

参数

getSDKShieldPublicNodeList 参数
名称位置类型必填说明
app_idpathstring是AppID, 16 lowercase hex

响应

getSDKShieldPublicNodeList 响应
状态码说明
200Signed node list

字段:schema: string key_id: string payload: string signature: string

404Error
429Error

失败时怎么办

  • 404 资源不存在或不属于当前租户。
  • 429 被限速:等待后再试,降低并发。

↑ 回到列表