4. 基线核验接口总览：核验接口分类、接口命名规范、接口路径设计、HTTP方法选择

基线核验接口是混沌工程平台与受测系统之间的契约边界。本章从接口分类、命名规范、路径设计、HTTP方法选择四个维度，建立一套可被模板驱动、可被自动化工具解析的接口调用规范。所有设计均遵循RESTful最佳实践，并针对混沌工程场景的特殊性（如异步核验、幂等重试、状态轮询）进行了定制化扩展。

4.1 核验接口分类

根据核验的触发时机与数据流向，基线核验接口划分为以下四大类：

4.2 接口命名规范

所有基线核验接口遵循统一的命名模板，确保可读性与自动化解析能力。命名模板如下：

/{domain}/{version}/verification/{category}/{action}

各段位的取值规则：

• {domain}：受测系统或模块的领域名称，使用小写字母与连字符，例如 payment、user-service、data-pipeline。
• {version}：接口版本号，固定格式 v{n}，例如 v1、v2。
• {category}：核验分类缩写，映射关系如下：
  • instant — 即时核验
  • async — 异步核验
  • batch — 批量核验
  • precheck — 预检核验
• {action}：具体核验动作，使用动词或动名词，例如 check-connectivity、compare-snapshot、validate-config。

4.3 接口路径设计

路径设计遵循资源导向与动作分离原则。核验本身被视为一种资源操作，路径中不嵌入查询参数用于核心业务逻辑。以下为路径设计规范对照表：

4.4 HTTP方法选择

基线核验接口严格遵循CRUD语义，但针对核验场景的特殊性，对HTTP方法的使用做出以下约定：

4.5 接口调用规范总览

以下为四种核心核验类型的完整接口定义速查表，涵盖路径、方法、请求与响应结构：

{
  "target": "10.0.1.5",
  "port": 3306,
  "timeoutMs": 3000
}

{
  "baselineId": "bl-20250301",
  "targetEnv": "staging"
}

{
  "items": [
    {"service": "auth", "configKey": "jwt.secret"},
    {"service": "payment", "configKey": "db.connection"}
  ]
}

{
  "experimentId": "exp-0421",
  "requiredCpu": 4,
  "requiredMemoryGb": 8
}