如何通过 API 使用严格模式
如果您希望 Multilogin 检查创建或更新配置文件的请求中是否明确包含所有必填字段,请使用严格模式。
➡️ 在 API 请求中添加请求头 X-Strict-Mode: true。如果不添加此请求头,Multilogin 将使用非严格模式,并在支持的情况下应用默认值。
如果严格模式下缺少必填字段,API 会返回错误,并列出缺少的字段。
严格模式与非严格模式
严格模式
使用 X-Strict-Mode: true 时,API 要求明确提供严格验证所需的所有字段。
- 缺少必填字段时会返回错误
- 响应会列出需要添加的字段
- 如果您希望完全控制请求值,而不是依赖默认值,请使用此模式
非严格模式
未添加 X-Strict-Mode 时,默认使用非严格模式。
- 省略的受支持字段可以使用 Multilogin 默认值
- 如果您不需要自行定义每个受支持的参数,请使用此模式
什么时候应该使用严格模式?
以下情况建议使用严格模式:
- 自动化流程必须发送明确的值,而不是依赖 Multilogin 默认值
- 您希望在一次验证响应中查看所有缺少的必填字段
- 您需要在不同自动化流程中保持一致的请求验证
如何使用严格模式
在 Postman 中打开“Headers” → 将 X-Strict-Mode 添加为 key → 将 true 输入为 value。如果您未指定此标头, API将默认使用非严格模式。

💡 如果在使用严格模式时遗漏了一个字段会发生什么?
系统会返回详细的错误信息,告知您哪些字段缺失。这比针对每个缺失字段单独报错更有帮助。