您的服务端代码现在对如何处理操作配置字段的破坏性变更拥有更多控制权。当出现字段不匹配时,不再因验证失败而中断;使用旧版操作的流程将继续执行,Shopify 仍会将请求发送到配置的端点 URL。您的服务端可以随后决定如何处理架构差异:例如,为新必填字段设置默认值、忽略已移除的字段,或拒绝该请求。
变更原因
此前,对操作配置字段的任何更改都被视为商户工作流中的破坏性变更。运行时验证会失败,Shopify 不会将请求发送到合作伙伴服务器。例如,如果添加了新的必填字段或移除了现有字段,使用该操作旧版本的所有工作流都将始终失败,且永远不会到达您的端点。
通过此次变更,这些工作流将继续运行,即使负载基于较旧的配置,您的端点也会收到请求。
您需要采取的措施
您的操作端点现在可能会收到与操作当前配置不完全匹配的负载,而是与商户在工作流中仍在使用的先前版本相匹配。请确保您的端点能够安全地处理以下情况:
- 在新版本中变为必填但缺失的字段
- 在旧版本中存在但现已移除的多余字段
- 任何其他意外字段或架构差异
常见的策略包括为缺失字段应用合理的默认值、忽略未知或遗留字段,或在无法安全处理负载时返回明确的错误响应。
有关请求发送和执行的更多详细信息,请参阅Flow action execution。

