创建端点规范或导入 API 规范后,你可以生成并发送请求以进行调试和验证。生成请求参数#
在 Apidog 的
设计优先模式 中,当你在
Edit 标签页中指定端点后,可以点击
Run 标签页切换到发送请求界面。在这里,会根据你定义的端点规范自动生成相应的请求。
对于 path 参数、query 参数、headers 以及 form-data 或 x-www-form-urlencoded 类型的 body,如果你在端点规范中指定了 example,该示例将自动填充到 Run 界面的 value 字段中,作为初始请求参数值。如果在 Edit 标签页中修改并保存了 endpoint specification 中的参数名称、描述、类型或示例等参数,Run 标签页中的相应字段也会随之更新。在规范中所做的任何更改都会反映到整个开发流程中,从而保持一致性和准确性。
生成请求主体#
如果你的请求主体是 JSON 或 XML 类型,则可以在 Apidog 中自动生成请求主体,而无需手动构建。请求主体示例和初始内容#
如果你的端点规范包含已定义的主体示例,该示例将作为初始主体内容显示在
Run 标签页中。
如果端点规范中未定义主体示例,Run 标签页中的主体字段将留空。不过,你可以点击 Auto-generate 来创建符合你需求的主体结构。自动生成选项#
Apidog 提供多种数据自动生成选项,以满足不同需求。你可以在 Auto-generate 下拉菜单中从多种生成方法中进行选择:1. 示例#
使用场景: 在不同业务场景的预定义示例之间手动切换,例如正常请求、异常请求或边界值测试。
2. 每次生成#
注意: 启用 Generate Each Time 后,在禁用此选项之前,主体内容将不可编辑。
3. 自动生成偏好#
点击 Auto-generation Preference 会打开一个弹出窗口,你可以在其中选择偏好的自动生成数据规则。功能: 如果请求数据 Schema 中定义了示例值,则会将其用于自动生成。如果未配置示例值,则会根据模拟规则生成随机值。
使用场景: 非常适合某些字段需要固定值,而其他字段可以动态生成的场景。
功能: 如果请求数据 Schema 中定义了默认值,则会将其用于自动生成。如果未配置默认值,则会根据模拟规则生成随机值。
功能: 仅使用请求数据 Schema 生成字段名,并将值留空。
使用场景: 在不同业务场景之间快速切换,例如正常请求或异常请求。
插入动态值#
你可以使用 动态值 为请求参数和请求主体生成值。这样,每次发送请求时,动态值都会被自动模拟并插入到请求中。在每个请求参数的输入框旁边,你会看到一个用于动态变量的 魔法棒 图标——点击该图标即可插入动态值。同样,在请求主体中,你可以点击 Insert Dynamic Value 按钮,在 JSON 或 XML 主体中插入动态值。发送请求#
Modified at 2026-06-09 08:55:47