请求体多示例配置
创建示例
直接添加示例
Apifox 版本需大于 2.7.0
进入 “修改接口” 页面，在请求参数中选择相应的 “请求体” 标签，点击 
+ 添加示例填写示例信息：示例名称（选填，默认 示例值（必填） 说明（支持 Markdown） OAS 字段名称（导出 OpenAPI 时的字段名，不填则使用序号） OAS 扩展（自定义扩展字段，导出时保留） 
示例 1/示例 2）保存后生效，调试时即可选择不同示例。
Raw 类型的请求体调试时仅显示第一个示例值。
提取参数为示例
调试时填写请求体，点击 “提取 -> 提取到请求示例”
可选择保存为 “新增示例” 或 “覆盖已有示例”
默认填充当前调试值到示例。
使用示例
调试场景
切换到 “运行” 页面，选择 “自动生成” 标签。
点击下拉框选择示例，示例值将自动填充。
支持实时切换示例发送请求。
文档展示
1开始自动递增）OAS 兼容性
OAS 字段名称
1.
在示例配置中填写
OAS 字段名称2.
examples 对象内元素的字段名1 开始递增）填写时
未填写时
"examples": {
"example1": {
"value": {
"name": "张三",
"category": "Lorem eu non",
"birthday": "2009-05-10"
},
"summary": "示例 1",
"description": "这是一个`示例 1`"
},
"example2": {
"value": {
"name": "昂婷婷",
"category": "et",
"birthday": "2012-10-28"
},
"summary": "示例 2",
"description": "这是一个`示例 2`"
}
} "examples": {
"1": {
"value": {
"name": "张三",
"category": "Lorem eu non",
"birthday": "2009-05-10"
},
"summary": "示例 1",
"description": "这是一个`示例 1`"
},
"2": {
"value": {
"name": "昂婷婷",
"category": "et",
"birthday": "2012-10-28"
},
"summary": "示例 2",
"description": "这是一个`示例 2`"
}
}OAS 扩展
1.
在示例配置的
OAS 扩展 字段中输入 JSON 格式键值对：{
"x-demo": true,
"x-scenario": "error_case"
}2.
扩展字段会完整保留至生成的 OpenAPI 文档：
"examples": {
"example1": {
"x-demo": true,
"x-scenario": "error_case",
"value": {
"name": "张三",
"category": "Lorem eu non",
"birthday": "2009-05-10"
},
"summary": "示例 1",
"description": "这是一个`示例 1`"
}
}