风险等级
riskLevel 是所选厂商的离散档位映射到平台 enum 后的值。它不是跨厂商分数,也不表示工作流状态。
该字段可以缺失。厂商不提供档位时,API 会省略;平台不会从数值分推导缺失档位。
| API 值 | 等级 | 含义 |
|---|---|---|
RISK_LEVEL_CRITICAL | 严重 | 该厂商映射后的最强风险档位。 |
RISK_LEVEL_HIGH | 高 | 该厂商映射后的高风险档位。 |
RISK_LEVEL_MEDIUM | 中 | 该厂商映射后的中风险档位。 |
RISK_LEVEL_LOW | 低 | 该厂商映射后的低风险档位;不表示所有选填情报字段都已提供。 |
数值分保留厂商原始量纲
score 与 riskLevel 分开。必须把 value、scale、state、polarity 一起读;不要跨厂商比较或重标分数。
量纲与方向属于作答的那家厂商,所以要从回包的 scale 与 polarity 读,不要假定取值范围:HIGHER_IS_SAFER 下分数越高越安全,HIGHER_IS_RISKIER 下越高越危险。NO_RULE_TRIGGERED 与 NOT_PROVIDED 都不是数值 0。
UNKNOWN、缺失与 UNSPECIFIED 不同
离散档位的几种状态要分开处理:
RISK_LEVEL_UNKNOWN表示离散档位不可用:可能没拿到,也可能厂商给了无法识别的新档位。它绝不能按 LOW 处理,但也不能仅凭 UNKNOWN 断言整次筛查失败;完成情况与其他数据要看 HTTP 结果和响应其余字段。RISK_LEVEL_UNSPECIFIED是 protobuf 为“enum 未设置”保留的零值。正常成功响应中没有档位时,riskLevel 会省略或为 null。
按 enum 与字段 presence 分支,不要按展示文案或自造分数阈值分支。