可运行指引

快速开始

三条路径分开:公开核验、受权诊断、正式评级申请。对应能力开启后显示生产步骤。

  1. 公开核验

    使用证书编号或 JWS 调用公开 verify 与 status 资源。

  2. 受权诊断

    需要客户授权与 L3 凭证。

  3. 正式评级申请

    返回异步任务;completed 不等于已签发证书。

公开核验步骤

  1. 打开 /zh/rank/verify 提交正式证书编号,或对原始 JWS 调用 POST /v1/certificates/verify。
  2. 按已配置 JWKS 校验 typ=vgo-rank+jwt、audience、issuer 与 ±60 秒时钟偏差。
  3. 状态与签名分开处理:撤销、过期、受限、未知不得与 VR0 混淆。

沙箱诊断(非正式评级)

批准后的 sbx_ 密钥可调用沙箱探测接口。勿将沙箱结果当作正式等级。

curl -sS -H "Authorization: Bearer $SBX_KEY" \
  https://sandbox-api.vgoframework.org/v1/diagnostics/preview

正式评级申请

异步任务 completed 不等于 certificate.issued。在 L4 授权开放前,本路径保持规划中。

API 契约公开核验申请密钥