VGO Rank API
线格式遵循 Framework OpenAPI 3.1。当前公开读取主机：https://api.vgoframework.org/v1。
环境
- 当前公开读取
https://api.vgoframework.org/v1- 生产基址
https://api.vgoframework.org/v1- 备用试验基址
https://sandbox-api.vgoframework.org/v1
Operation 参考
下列 operationId 与冻结 OpenAPI 一一对应。规划中项不提供生产调用按钮。
| operationId | 方法 | 路径 | 鉴权 | 门户状态 |
|---|---|---|---|---|
listProtocols | GET | /protocols | anonymous | 规划中 |
submitEntity | POST | /entities | oauth2 | 受限开放 |
getEntity | GET | /entities/{entityId} | oauth2 | 受限开放 |
createScope | POST | /scopes | oauth2 | 受限开放 |
getScope | GET | /scopes/{scopeId} | oauth2 | 受限开放 |
startDiagnosticRun | POST | /diagnostic-runs | oauth2 | 受限开放 |
getDiagnosticRun | GET | /diagnostic-runs/{runId} | oauth2 | 受限开放 |
requestRating | POST | /rating-requests | oauth2 | 受限开放 |
getRatingRequest | GET | /rating-requests/{requestId} | oauth2 | 受限开放 |
getCurrentCertificate | GET | /scopes/{scopeId}/current-certificate | anonymous | 生产可读 |
getCertificate | GET | /certificates/{certificateId} | anonymous | 生产可读 |
getCertificateStatus | GET | /certificates/{certificateId}/status | anonymous | 生产可读 |
getIssuerJwks | GET | /.well-known/jwks.json | anonymous | 生产可读 |
verifyCertificate | POST | /certificates/verify | anonymous | 生产可读 |
listRankings | GET | /rankings | anonymous | 规划中 |
submitAppeal | POST | /appeals | oauth2 | 受限开放 |
getAppeal | GET | /appeals/{appealId} | oauth2 | 受限开放 |
createSubscription | POST | /subscriptions | oauth2 | 沙箱 |
receiveRankEvent | POST | webhook:rankEvent | oauth2 | 沙箱 |
createDiagnosisRun | POST | /v1/diagnosis-runs | oauth2 | 规划中 |
getDiagnosisRun | GET | /v1/diagnosis-runs/{run_id} | oauth2 | 规划中 |
cancelDiagnosisRun | POST | /v1/diagnosis-runs/{run_id}/cancel | oauth2 | 规划中 |
listDiagnosisDimensions | GET | /v1/diagnosis-runs/{run_id}/dimensions | oauth2 | 规划中 |
listDiagnosisMetrics | GET | /v1/diagnosis-runs/{run_id}/metrics | oauth2 | 规划中 |
listDiagnosisFindings | GET | /v1/diagnosis-runs/{run_id}/findings | oauth2 | 规划中 |
listDiagnosisRecommendations | GET | /v1/diagnosis-runs/{run_id}/recommendations | oauth2 | 规划中 |
getDiagnosisEvidenceSummary | GET | /v1/diagnosis-runs/{run_id}/evidence-summary | oauth2 | 规划中 |
getDiagnosisRetestDiff | GET | /v1/diagnosis-runs/{run_id}/retest-diff | oauth2 | 规划中 |
createVerificationRequest | POST | /v1/diagnosis-runs/{run_id}/verification-requests | oauth2 | 规划中 |
getDiagnosisProtocolManifest | GET | /v1/protocols/diagnosis/{version} | oauth2 | 规划中 |
getMeasurementProtocolManifest | GET | /v1/protocols/measurement/{version} | oauth2 | 规划中 |
公开资源
- 证书
GET /v1/certificates/{id}
签名签发事实与状态地址。- 现行状态
GET /v1/certificates/{id}/status
现行 rated、watch、restricted、revoked 或 expired。- 证书验证
POST /v1/certificates/verify
检查签名和现行状态，不返回私有证据。- 批准公开的榜单
GET /v1/rankings
只返回获准的市场与行业快照。
权限与错误
公共只读查询可匿名但有速率限制；诊断与评级申请须凭证与权限。响应须区分证据不足、评级不合格、观测面不可用、限流和证书撤销。缺样本不等于 VR0。
结果与状态语义
- 未评级
- 资格或证据门槛未通过，不含数字等级。
- VR0
- 资格合格、有效采样后获得的正式 VR0。
- rated / watch
- 在作用域内可作为现行引用；watch 须显著提示。
- restricted／revoked／expired／unknown
- 不得展示现行有效徽章；历史签发事实可保留。