如何通过 API 使用严格模式
如果希望 Multilogin 检查配置文件创建或更新请求中是否明确提供了所有必填字段,可以使用严格模式。
➡️ 在请求中添加请求头 X-Strict-Mode: true,即可启用严格模式。如果省略此请求头,API会使用非严格模式,并在支持的情况下应用默认值。
严格模式下,如果缺少必填字段,API会返回错误,并列出缺失的字段。
严格模式与非严格模式
严格模式
设置 X-Strict-Mode: true 后,API要求明确提供严格验证所需的所有字段。
- 缺少必填字段时返回错误
- 响应会列出需要添加的字段
- 希望完全控制请求值,而不是依赖默认值时,使用此模式
非严格模式
未提供 X-Strict-Mode 时,默认使用非严格模式。
- 支持省略的字段可使用 Multilogin 默认值
- 不需要自行定义每个支持的参数时,使用此模式
什么时候应该使用严格模式?
以下情况适合使用严格模式:
- 自动化必须发送明确的值,而不能依赖 Multilogin 默认值
- 希望在一次验证响应中获得所有缺失必填字段的信息
- 需要让各自动化工作流程采用一致的请求验证方式
如何使用严格模式
在 Postman 中,打开“Headers” → 添加键 X-Strict-Mode → 输入值 true。 如果未指定,API默认使用非严格模式。

💡 使用严格模式时漏填字段会怎样?
系统会返回详细错误信息,说明缺少哪些字段。这样比每个缺失字段分别报错更方便处理。